Patreon 主页或对象详情 API
POST
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
正常
24 小时趋势
30 天趋势
主页或对象详情:返回单个对象;主要字段 id、name、vanity、url、creation_name、one_liner。
请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 patreon,action 填 profile。 单价 $1.39 / 千次(每次 $0.001389),失败和空结果都不收费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。
AI 提示词
#请帮我用 EveryInfra 的「Patreon 主页或对象详情」接口(patreon/profile)写一个数据采集脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 patreon,action 填 profile,参数放在 params 里。
- 必填参数:
- username:profile / user_posts 的创作者短名,可写 @短名,或含 /c/短名 的 Patreon 链接。只读取公开资料、档位与公开帖子信息,不提供付费墙内正文。
- 返回一个对象,主要字段:id、name、vanity(主页短名)、url、creation_name(创作项目名(「正在创作 XX」里的…)、one_liner(一句话介绍)、summary(简介)、currency、patron_count(赞助者总数)、paid_member_count(付费会员数)、post_count、pay_per(计费单位(按月/按作品));一共 24 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=patreon。
- 示例请求体:
{
"platform": "patreon",
"action": "profile",
"params": {
"username": "kurzgesagt"
}
}
- 计费:$1.39 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
platform | body | string | 是 | patreon | 平台标识,固定值。 |
action | body | string | 是 | profile | 能力标识,固定值。 |
username | body.params | string | 是 | - | profile / user_posts 的创作者短名,可写 @短名,或含 /c/短名 的 Patreon 链接。只读取公开资料、档位与公开帖子信息,不提供付费墙内正文。 |
代码示例
#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"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
响应示例
#2026年10月25日 06:01(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息;id、billing、quota 每次调用都不同,只给结构。
json
{ "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": { … }}
返回字段
#业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被编造。
| 字段 | 含义 |
|---|---|
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 | 保留平台原语义 |
tier_count | 保留平台原语义 |
socials | 保留平台原语义 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。
官方资料参照
#只用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。
- Patreon:会员数量快照不等于已处理收入 ↗
Patreon 将页面会员与收入概览视为会波动的快照,并把实际处理收入放在专门报表中。公开 paid_member_count、计费单位与币种不提供交易明细,不能直接相乘得到真实收入或已结算金额。
核对于 2026-09-04