下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。
下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。
所有能力都是同步调用。
| 能力 | 必填参数 | 可选参数 | 单次条数 | 单价空白行均为 $1.39 / 千次 | 返回字段 |
|---|---|---|---|---|---|
| search | keyword | — | 默认 20 · 最多 50 | $24 / 千次 | name · vanity · url · tagline · patron_count · post_count · rank · category · days_running · published_at · avatar_url · platform |
| explore | category | — | 默认 20 · 最多 50 | name · vanity · url · tagline · patron_count · post_count · rank · category · days_running · published_at · avatar_url · platform | |
| profile | username | — | — | id · name · vanity · url · creation_name · one_liner · summary · currency · patron_count · paid_member_count · post_count · pay_per · is_monthly · is_nsfw · offers_free_membership · offers_paid_membership · published_at · pledge_url · avatar_url · cover_url · main_video_url · platform · tiers · tier_count · socials | |
| user_posts | username | — | 默认 20 · 最多 50 | id · title · text · url · post_type · like_count · comment_count · is_public · author_vanity · thumbnail_url · posted_at · platform |
search使用 platform="patreon"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 name、vanity、url、tagline、patron_count、post_count 等 12 个字段。
keyword必填Patreon 官方介绍以创作者名字或主题发现账号，且原站 Explore 包含个性化内容。本页是创作者检索，不提供个人登录后的推荐历史，也不扩为付费作品全文搜索。官方来源：Patreon：按创作者名称或主题发现账号来源核查：
vanitytaglinepatron_countdays_runningrankpublished_atexplore使用 platform="patreon"、action="explore" 调用“创作者发现”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 name、vanity、url、tagline、patron_count、post_count 等 12 个字段。
category必填Patreon 的发现页结合主题、会员与过去活动，并对 Adult/18+ 创作者设置年龄与访问条件。本接口分类值不等于官方全部分类或个人推荐，也不解除年龄及内容限制。官方来源：Patreon：分类发现与个人推荐、年龄设置分开来源核查：
3d-printingadult-3d-printingadult-animationadult-comicsadult-cosplayadult-crafts-diyadult-dance-theateradult-drawing-paintingadult-gamesadult-magazineadult-musicadult-otheradult-photographyadult-podcastsadult-videoadult-writinganimalsanimationcomicscosplaycrafts-diydance-theaterdrawing-paintingfinancegamesmagazinemastodonmusicotherphotographypodcaststop-1000videowriting
vanitytaglinepatron_countdays_runningrankpublished_atprofile使用 platform="patreon"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 id、name、vanity、url、creation_name、one_liner 等 25 个字段。
Patreon 将页面会员与收入概览视为会波动的快照，并把实际处理收入放在专门报表中。公开 paid_member_count、计费单位与币种不提供交易明细，不能直接相乘得到真实收入或已结算金额。官方来源：Patreon：会员数量快照不等于已处理收入来源核查：
username必填vanitypatron_countpublished_atcreation_nameone_linersummarypaid_member_countpay_peris_monthlyoffers_free_membershipoffers_paid_membershipis_nsfwcover_urlmain_video_urlpledge_urluser_posts使用 platform="patreon"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、title、text、url、post_type、like_count 等 12 个字段。
username必填Patreon 将公开、会员和选定付费档位的帖子访问分开，部分帖子还支持单次购买。这里读取公开预览，不取得这些访问资格，也不因为展示 is_public 就具有购买、切换档位或解锁内容的能力。官方来源：Patreon：公开访问、会员访问与指定档位权限来源核查：
author_vanityis_publicpost_typePatreon 原始字段名
EveryInfra 统一字段名
左边是 Patreon 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。
全站 106 个平台的当前目录中，这 16 个字段名只在 Patreon 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。
vanitypatron_countdays_runningcreation_nameone_linerpaid_member_countpay_peris_monthlyoffers_free_membershipoffers_paid_membershippledge_urlmain_video_urltierstier_countis_publicauthor_vanity通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields
namevanityurltaglinepatron_countpost_countrankcategorydays_runningpublished_atavatar_urlplatformidcreation_nameone_linersummarycurrencypaid_member_countpay_peris_monthlyis_nsfwoffers_free_membershipoffers_paid_membershippledge_urlcover_urlmain_video_urltitletextpost_typelike_countcomment_countis_publicauthor_vanitythumbnail_urlposted_at当前目录另列出 tiers · tier_count · socials，这些字段尚无逐项释义；请先核对 Patreon 对应接口的用例与实际响应，不按字段名猜测类型或含义。
按创作者主题检索主页，不是搜索付费帖全文。
以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer $EVERYINFRA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"patreon","action":"search","params":{"keyword":"watercolor"}}'
仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。
{ "name": null, "vanity": null, "url": null, "tagline": null, "patron_count": null, "post_count": null, "rank": null, "category": null, "days_running": null, "published_at": null, "avatar_url": null, "platform": null }
以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。
用 search 找创作者候选，先保留主页短名与公开简介。
查看 search 的 keyword 参数用 explore 选择明确分类，不把分类目录当成个人推荐或收入榜。
查看 explore 的 category 参数用 profile 查看公开创作项目与会员开关，不据此估算真实到账收入。
查看 profile 的 username 参数用 user_posts 保存标题、预览与访问标记，不把预览承诺成付费正文。
查看 user_posts 的 username 参数调用 POST /api/v1/social，请求体传 platform="patreon"、action 和 params。以 search 为例，必填 keyword，没有可选参数。按创作者主题检索主页，不是搜索付费帖全文。 Patreon 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。
每千次 $1.39 起，按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 41 次 Patreon 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。
Patreon 有 3 个列表接口，包括 search、explore、user_posts。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。
当前目录为 search 列出 name、vanity、url、tagline、patron_count、post_count 等 12 个字段名。按全站当前目录统计，16 个字段名只在 Patreon 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。
用 search 找创作者候选，先保留主页短名与公开简介。 keyword 是创作者名称或主题检索词。name 是显示名称，vanity 是主页短名，url 指向创作者主页；不是搜索付费帖、商品订单或会员档位，也不能用同名结果来判断同一身份。 tagline、post_count 与 patron_count 是公开目录字段，数量可能缺失，patron_count 也不能一律当作付费会员数。category 虽为可选参数，搜索模式的实际过滤效果尚未确认。
用 explore 选择明确分类，不把分类目录当成个人推荐或收入榜。 category 参数使用 Patreon 接口允许的值，例如 podcasts、video、3d-printing、crafts-diy；explore 的分类名称使用连字符，与 search 中的 category 值域不同，不应互换。top-1000 是 Patreon 目录选项，不保证返回完整的 1000 条。 rank 与 category 只按返回记录理解，不推断为 Patreon 全平台收入排名或自己的登录后推荐。adult- 前缀仍受年龄和平台访问规则约束，存在分类枚举不等于允许绕过这些限制。
用 profile 查看公开创作项目与会员开关，不据此估算真实到账收入。 username 填创作者 vanity 短名、@短名或 /c/短名 的 Patreon 主页；不是显示名称或单篇 /posts/ 链接。name、creation_name、vanity 与 url 分别保留创作者、创作项目和主页标识。 offers_free_membership 与 offers_paid_membership 说明可提供的会员形式，paid_member_count 与 patron_count 计算方式不同，缺失不补零。currency、pay_per、is_monthly 不能直接组合为已结算收入；会员等级定价的目录展示仍有缺口，不承诺完整价目表。
用 user_posts 保存标题、预览与访问标记，不把预览承诺成付费正文。 username 指定创作者主页短名；text 只映射公开 teaser 文字，可能缺失，title 与 url 可标识帖子。is_public 是内容可见性标记，不是当前请求具有某个会员等级的授权证明。 post_type、like_count、comment_count 与 posted_at 描述已取得条目，不提供评论正文、购买、会员登录或付费墙内内容。本页也没有按单帖 URL 获取详情的 action；可见预览不附带再分发或训练许可。
可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小时内有效。请先选择 Patreon 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。
自有访问统计常开；Google Analytics 仅在你点「同意分析」后启用。 隐私政策