# Patreon Details API (patreon.profile)

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

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | Specifies the creator vanity slug for the profile and user_posts actions. Accepts @slug, a raw handle, or a Patreon URL containing /c/slug. Only retrieves public creator profile information, tier structures, and public posts, without accessing gated subscriber-only content. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| name | Name of the object itself, for account, product and business capabilities. |
| vanity | platform-native meaning |
| url | Link to the record on the platform. |
| creation_name | platform-native meaning |
| one_liner | platform-native meaning |
| summary | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| patron_count | platform-native meaning |
| paid_member_count | platform-native meaning |
| post_count | Total posts. null means not disclosed, not 0. |
| pay_per | platform-native meaning |
| is_monthly | platform-native meaning |
| is_nsfw | platform-native meaning |
| offers_free_membership | platform-native meaning |
| offers_paid_membership | platform-native meaning |
| published_at | platform-native meaning |
| pledge_url | platform-native meaning |
| avatar_url | Avatar image link. Some platforms return sized CDN links that can expire. |
| cover_url | platform-native meaning |
| main_video_url | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| tiers | platform-native meaning |
| tier_count | platform-native meaning |
| socials | platform-native meaning |

## 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": "profile",
  "params": {
    "username": "kurzgesagt"
  }
}'
```

```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": "profile",
        "params": {
            "username": "kurzgesagt",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T22:01:06Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "patreon",
  "action": "profile",
  "results": {
    "id": "73401",
    "name": "Kurzgesagt – In a Nutshell",
    "vanity": "Kurzgesagt",
    "url": "https://www.patreon.com/Kurzgesagt",
    "creation_name": "Creating Science Animation Videos",
    "one_liner": "Science Videos made with Love.",
    "summary": "Hello! We are kurzgesagt, one of the largest sciency channels on YouTube. We believe that nothing is boring if you tell a good story and we try to tell these stories. Our core mission is to spark curiosity and inspire people all around the world to go out and learn more about spa…",
    "currency": "USD",
    "post_count": 535,
    "pay_per": "month",
    "is_monthly": true,
    "is_nsfw": false,
    "published_at": "2013-08-30T16:09:54+00:00",
    "pledge_url": "https://www.patreon.com/checkout/Kurzgesagt",
    "avatar_url": "https://c10.patreonusercontent.com/•••",
    "cover_url": "https://c10.patreonusercontent.com/4/patreon-media/p/campaign/73401/e648561d635d45e7abf9a3cb68098e83/eyJ3IjoxOTIwLCJ3ZSI6MX0%3D/1.png?token-hash=LJ_8XtEuk7fh0N3mcws2ZuXFVrePObKqMxZeqNHkHEM%3D&token-time=1793750400",
    "main_video_url": "https://youtu.be/1x-i9z617z4",
    "platform": "patreon",
    "tiers": [
      {
        "title": "Free",
        "amount_cents": 0,
        "amount_usd": 0,
        "currency": "USD",
        "is_free": true,
        "post_count": 8,
        "url": "https://www.patreon.com/checkout/Kurzgesagt?rid=10010522"
      },
      {
        "title": "Trainee Producer",
        "description": "Perks: You're helping ensure the survival of high-quality content! AdBlock absolution ❤️ Early access to special product launches (like our calendar!) Occasional behind-the-scenes images or notes from the studio",
        "amount_cents": 314,
        "amount_usd": 3.14,
        "currency": "USD",
        "is_free": false,
        "post_count": 1,
        "url": "https://www.patreon.com/checkout/Kurzgesagt?rid=22201322"
      },
      {
        "title": "Producer",
        "description": "You receive all the perks from the Trainee Producer tier PLUS: Access to 1,100+ exclusive wallpapers over 24h of music! Video teasers one day before release Your name in the video description on the first month of subscription A personalized certificate from Duck 💌 Regular update…",
        "amount_cents": 1500,
        "amount_usd": 15,
        "currency": "USD",
        "is_free": false,
        "post_count": 64,
        "url": "https://www.patreon.com/checkout/Kurzgesagt?rid=28691"
      }
    ],
    "tier_count": 4,
    "socials": {
      "twitter": "Kurz_Gesagt",
      "youtube": "https://www.youtube.com/channel/UCsXVk37bltHxD1rDPwtNM8Q",
      "facebook": "https://www.facebook.com/Kurzgesagt?ref=hl",
      "instagram": "https://www.instagram.com/kurzgesagt"
    }
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

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