# Patreon Search API (patreon.search)

- Canonical page: [https://everyinfra.com/en/patreon-api/search](https://everyinfra.com/en/patreon-api/search?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "patreon", "action": "search", "params": {...}}
- Price: $0.024 per call ($24 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

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.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=patreon&action=search

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies creator search terms for the search action. Queries creator landing profile pages rather than full-text post contents behind paywalls. |
| limit | 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. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| name | Name of the object itself, for account, product and business capabilities. |
| vanity | platform-native meaning |
| url | Link to the record on the platform. |
| tagline | platform-native meaning |
| patron_count | platform-native meaning |
| post_count | Total posts. null means not disclosed, not 0. |
| rank | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| days_running | platform-native meaning |
| published_at | platform-native 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). |

## Example

```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"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "patreon",
        "action": "search",
        "params": {
            "keyword": "watercolor",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "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": { … }
}
```

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

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=patreon
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
