POST

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

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

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYespatreonPlatform identifier, fixed value.
actionbodystringYessearchCapability identifier, fixed value.
keywordbody.paramsstringYes-Specifies creator search terms for the search action. Queries creator landing profile pages rather than full-text post contents behind paywalls.
limitbody.paramsinteger (1–50)No20The 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

#
bash
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

#
Captured September 26, 2026 at 08:56 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "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.

FieldMeaning
nameName of the object itself, for account, product and business capabilities.
vanityKeeps the platform's own meaning
urlLink to the record on the platform.
taglineKeeps the platform's own meaning
patron_countKeeps the platform's own meaning
post_countTotal posts. null means not disclosed, not 0.
rankKeeps the platform's own meaning
categoryCategory name in the platform's own taxonomy, not normalized across platforms.
days_runningKeeps the platform's own meaning
published_atKeeps the platform's own meaning
avatar_urlAvatar image link. Some platforms return sized CDN links that can expire.
platformSource 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.

Errors

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

Google Analytics needs consent. Privacy