Patreon Search API
API health
- 24h health
- Normal
- Healthy / normal
- Available
- Limited
- Mostly down
Last 24 hours
Last 30 days
Look up Patreon creators by keyword, with tagline, category, patron and post counts, leaderboard rank and how many days each page has been running. Matching runs on creator pages, not post text, and income, member identities and paid content stay hidden.
Send POST https://api.everyinfra.com/api/v1/social with platform set to patreon and action set to search. Price $24 per 1,000 requests ($0.024 per call). Failed calls and empty results are not charged. Synchronous. For slow jobs add "mode": "async" to the body, take the job_id and poll.
Patreon Search finds creator pages on Patreon by keyword, such as watercolor, and returns each creator's name, short name in vanity, tagline, category, patron and post counts, days running, publish time, leaderboard rank, avatar and page link. It answers who is building patron support in a niche and at what scale, for brands and agencies looking for creators to sponsor, analysts sizing creator niches and creators studying their peers.
The search matches creator pages, not the text of posts, paid or free. Read patron_count with days_running, the number of days the page has been running, to tell established pages from new ones. A null post_count means the count was not disclosed, not zero. To go further, pass vanity to the Patreon Details capability for tiers and profile data, or to Patreon Posts by user for the creator's posts.
AI prompt
#Please help me write a data collection script with the EveryInfra Patreon Search endpoint (patreon/search).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to patreon and action to search, and put the parameters inside params.
- Required parameters:
- keyword: Specifies creator search terms for the search action. Queries creator landing profile pages rather than full-text post contents behind paywalls.
- Optional parameters:
- limit: The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. (default: 20)
- Returns a list of records. Main fields of each record: name, vanity, url, tagline, patron_count, post_count, rank, category, days_running, published_at, avatar_url.
- Example request body:
{
"platform": "patreon",
"action": "search",
"params": {
"keyword": "watercolor"
}
}
- Price: $24 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | patreon | Platform identifier, fixed value. |
action | body | string | Yes | search | Capability identifier, fixed value. |
keyword | body.params | string | Yes | - | Specifies creator search terms for the search action. Queries creator landing profile pages rather than full-text post contents behind paywalls. |
limit | body.params | integer (1–50) | No | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "patreon",
"action": "search",
"params": {
"keyword": "watercolor"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
Response example
#{ "id": "req_…", "platform": "patreon", "action": "search", "results": [ { "name": "Karen Rice Art", "vanity": "karenriceart", "url": "https://www.patreon.com/karenriceart", "tagline": "Step by Step Watercolor / Watercolour Tutorials", "avatar_url": "https://c10.patreonusercontent.com/•••", "platform": "patreon" }, { "name": "Kristin Van Leuven", "vanity": "kristinvanleuven", "url": "https://www.patreon.com/kristinvanleuven", "tagline": "Painting with watercolor together", "avatar_url": "https://c10.patreonusercontent.com/•••", "platform": "patreon" } ], "count": 20, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.
| Field | Meaning |
|---|---|
name | Name of the object itself, for account, product and business capabilities. |
vanity | Keeps the platform's own meaning |
url | Link to the record on the platform. |
tagline | Keeps the platform's own meaning |
patron_count | Keeps the platform's own meaning |
post_count | Total posts. null means not disclosed, not 0. |
rank | Keeps the platform's own meaning |
category | Category name in the platform's own taxonomy, not normalized across platforms. |
days_running | Keeps the platform's own meaning |
published_at | Keeps the platform's own meaning |
avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
FAQ
#What does keyword search?
#Creator pages, matched on the theme of the creator's work, such as watercolor or podcasts. Patreon Search does not search the text of posts, including paid ones. To browse creators by Patreon's own categories instead of a keyword, use the Patreon Explore capability, which takes a category.
How do I get a creator's posts or tiers from a search result?
#Take the vanity value, the creator's short name, and pass it as the username to Patreon Posts by user for their posts or to Patreon Details for their profile and tiers. Both read public information only, so posts behind the paywall come without their paid content.
How do I compare creators fairly?
#Compare patron_count within one category, since niches differ in size, and read it with days_running so a new page is not judged against one that has run for years. A null post_count is not zero; it means the count was not disclosed. rank gives the creator's leaderboard position as a further reference.
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
Official references
#Used only to check objects and terms. They do not imply authorization or endorsement of EveryInfra by the platform.
- Patreon: Account Discovery by Creator Name or Topic ↗
Patreon supports creator discovery by name or topic, and its native Explore feature includes personalized recommendations. This endpoint handles creator searches; it does not return personalized recommendation history or full-text search results for paid posts.
Checked 2026-09-04