# Patreon 主页或对象详情 API (patreon.profile)

- Canonical page: [https://everyinfra.com/patreon-api/profile](https://everyinfra.com/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 | profile / user_posts 的创作者短名，可写 @短名，或含 /c/短名 的 Patreon 链接。只读取公开资料、档位与公开帖子信息，不提供付费墙内正文。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| name | 名称。用于账号/商品/商家类能力，指该对象本身的名字。 |
| vanity | 主页短名。 |
| url | 该记录在原平台上的可访问链接。 |
| creation_name | 创作项目名（「正在创作 XX」里的 XX）。 |
| one_liner | 一句话介绍。 |
| summary | 简介。 |
| currency | 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。 |
| patron_count | 赞助者总数。 |
| paid_member_count | 付费会员数。**部分创作者隐藏此数，null 不等于 0**。 |
| post_count | 发布内容总数。null 表示不公开，不等于 0。 |
| pay_per | 计费单位（按月/按作品）。 |
| is_monthly | 是否按月收费。 |
| is_nsfw | 是否为成人内容。 |
| offers_free_membership | 是否有免费档。 |
| offers_paid_membership | 是否有付费档。 |
| published_at | 发布时间。 |
| pledge_url | 赞助链接。 |
| avatar_url | 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。 |
| cover_url | 封面图。 |
| main_video_url | 主推视频。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 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
