call
POST /v1/call/{op} 调用某个平台独有的接口,比如达人报价或商品评价。op 写成“平台.名称”。目前在 12 个平台,另有 2 个广告库上开放了 102 个这样的接口。它们的返回和六个动作是同一种外层结构,失败的调用不扣。
https://socialtoai.app/v1/call/{op}请求
op 写在路径里,参数放在 JSON 请求体里。max_cost_credits 和 Idempotency-Key 的用法和其他计费调用一样。
curl https://socialtoai.app/v1/call/tiktok.top_ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "7686210433094729735" }'import osimport uuidimport requestsresponse = requests.post( "https://socialtoai.app/v1/call/tiktok.top_ad_detail", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "id": "7686210433094729735", },)print(response.json()){ "request_id": "req_00000000-0000-4000-8000-000000000001", "schema_version": "v1", "fetched_at": "2026-10-12T22:12:08.000Z", "action": "call", "op": "tiktok.top_ad_detail", "platform": "tiktok", "status": "ok", "items": [ { "platform": "tiktok", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "entry", "entry_type": "ad", "title": null, "url": "https://example.com/…", "rank": null, "heat": null, "fields": { "format": "video", "text": "…", "landing_url": "https://example.com/…", "advertiser": { "id": null, "name": "…", "url": null }, "images": null, "first_shown_at": null, "last_shown_at": null } } ], "unavailable": ["title", "fields.images", "fields.first_shown_at", "fields.last_shown_at", "fields.advertiser.id", "fields.advertiser.url"], "warnings": [], "applied_params": { "id": "7686210433094729735" }, "cost_credits": 2, "billing": { "cost_credits": 2, "balance_credits": 98, "today_spend_credits": 2, "daily_limit_credits": null, "daily_remaining_credits": null, "display": "本次 2 积分(约 $0.0067),余额 98 积分(约 $0.33)" }, "replayed": false}示例数据:名字、链接和正文已换成占位符。
接口
TikTok
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
tiktok.top_ad_detail | 2 | 创意中心热门广告详情:按编号取 TikTok 创意中心的一条热门广告(Top Ads)。 | id | – |
tiktok.top_ad_search | 2 | 创意中心热门广告搜索:按关键词搜 TikTok 创意中心的热门广告(Top Ads)。 | query | region、window、sort |
tiktok.hashtag_videos | 2 | 话题作品:按话题名取一页带这个话题的 TikTok 视频,每页约 20 条。 | id | – |
tiktok.product_reviews | 2 | Shop 商品评价:按商品编号取 TikTok Shop 美国站这件商品排在最前的 10 条买家评价。 | id | – |
tiktok.product_search | 2 | Shop 商品搜索:按搜索词取 TikTok Shop 美国站的商品。 | query | – |
tiktok.seller_products | 2 | Shop 店铺商品:按店铺编号取一页这家 TikTok Shop 美国站店铺在售的商品。 | id | – |
tiktok.product_detail | 2 | Shop 商品详情:按商品编号取 TikTok Shop 美国站的一件商品。 | id | – |
tiktok.ad_search | 2 | 广告库搜索:按关键词或广告主名字搜 TikTok 公开广告库(欧洲地区投放的广告)。 | query、advertiser 里给一个 | – |
tiktok.ad_detail | 2 | 广告库广告详情:按编号或链接取 TikTok 公开广告库里的一条广告。 | id、url 里给一个 | – |
tiktok.followers | 2 | 用户粉丝列表:按账号名取一页关注该 TikTok 用户的账号,每页 50 个,从最新关注的开始。 | username | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见TikTok 页。
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
instagram.hashtag_posts | 2 | 话题帖子:按话题名取一页带这个话题的最新 Instagram 帖子,每页约 33 条。 | id | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Instagram 页。
X
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
x.community | 1 | 社群资料:按社群编号取 X 社群的资料。 | id | – |
x.community_posts | 4 | 社群帖子:按社群编号取一页这个 X 社群里的帖子。 | id | – |
x.list_posts | 2 | 列表帖子:按列表编号取一页这个 X 列表时间线上的帖子,从最新的开始,每页约 100 条。 | id | – |
x.article | 2 | 长文详情:按帖子编号取这条 X 帖子附带的长文。 | id | – |
x.quotes | 4 | 帖子引用列表:按帖子编号取一页引用它的 X 帖子,可按时间或按热门排。 | id | – |
x.retweeters | 2 | 帖子转推用户:按帖子编号取一页转推了这条 X 帖子的账号。 | id | – |
x.thread | 9 | 帖子对话串:按对话串里任意一条帖子的编号,取这条对话串的帖子。 | id | – |
x.followers | 12 | 用户粉丝列表:按账号名取一页关注该 X 用户的账号,每页最多 200 个,从最新关注的开始。 | username | – |
x.following | 12 | 用户关注列表:按账号名取一页该 X 用户关注的账号,每页最多 200 个。 | username | – |
x.mentions | 4 | 用户提及:按账号名取一页提及该 X 用户的帖子,从最新的开始。 | username | – |
x.community_members | 5 | 社群成员:按社群编号取一页加入了这个 X 社群的账号,每页约 20 个。 | id | – |
x.list_followers | 5 | 列表关注者:按列表编号取关注了这个 X 列表的账号,最多 20 个。 | id | – |
x.list_members | 5 | 列表成员:按列表编号取一页这个 X 列表收录的账号,每页 20 个。 | id | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见X 页。
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
reddit.user_subreddits | 2 | 用户活跃社区:按用户名取这个 Reddit 用户活跃的社区。 | username | – |
reddit.subreddit | 2 | 社区资料:按社区名取 Reddit 社区的资料。 | id | – |
reddit.subreddit_posts | 2 | 社区帖子:按社区名取一页该 Reddit 社区的帖子,可按热门、最新或最高分排。 | id | sort、window |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Reddit 页。
YouTube
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
youtube.community_posts | 2 | 频道帖子:按频道编号或账号名取一页该 YouTube 频道“帖子”栏(原“社区”)里的帖子,从最新的开始。 | id、username 里给一个 | – |
youtube.community_post | 2 | 帖子详情:按帖子编号或链接取一条 YouTube 频道帖子(原“社区”帖)。 | id、url 里给一个 | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见YouTube 页。
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
linkedin.ad_detail | 2 | 广告详情:按编号或链接取 LinkedIn 广告库里的一条广告。 | id、url 里给一个 | – |
linkedin.ad_search | 2 | 广告库搜索:按关键词或公司名搜 LinkedIn 广告库里的广告。 | query、advertiser 里给一个 | region |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见LinkedIn 页。
小红书
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
xiaohongshu.kol_search | 24 | 蒲公英博主搜索:按搜索词找蒲公英上的小红书博主(按博主写的内容匹配)。 | – | query、sort、followers_min、followers_max、rate_min、rate_max、cpm_min、cpm_max、median_reads_min、median_engagements_min、sponsored_median_reads_min、type、category、feature_tag、persona、location、gender、audience_gender、audience_age、industry、exclude |
xiaohongshu.kol_profile | 24 | 蒲公英博主详情:按蒲公英博主编号取这位小红书博主在蒲公英上的资料。 | id | – |
xiaohongshu.kol_audience | 24 | 蒲公英博主粉丝画像:按蒲公英博主编号取这位小红书博主的粉丝画像。 | id | – |
xiaohongshu.kol_performance | 24 | 蒲公英博主数据表现:按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记或合作笔记的数据表现。 | id | window、tab |
xiaohongshu.keyword_history | 24 | 蒲公英关键词逐日搜索指数:按一个关键词取它在小红书上最近约三个月逐日的搜索指数(蒲公英),并带每天和这个词有关的笔记数、曝光数、阅读数和互动数。 | keyword | – |
xiaohongshu.product_search | 12 | 商品搜索:按搜索词取一页小红书商城的商品。 | query | – |
xiaohongshu.product_detail | 12 | 商品详情:按商品编号取小红书商城的一件商品。 | id | – |
xiaohongshu.product_reviews | 12 | 商品评价:按商品编号取小红书商城这件商品排在最前的一页买家评价。 | id | – |
xiaohongshu.kol_notes | 24 | 蒲公英博主笔记:按蒲公英博主编号取一页这位小红书博主的笔记(蒲公英的“笔记案例”),带蒲公英给的数据。 | id | tab、type、sort、traffic、feature_tag、category |
xiaohongshu.topic_notes | 12 | 话题笔记:按话题页编号取该话题下的热门笔记。 | id | – |
xiaohongshu.keyword_related | 24 | 蒲公英关联词:按一个关键词取小红书用户搜它之前和之后还会搜的词(蒲公英),各带相关度名次、搜索指数、相关笔记数和阅读数,用来拓词选题。 | keyword | – |
xiaohongshu.topic | 12 | 话题详情:按话题页编号取一个小红书话题。 | id | – |
xiaohongshu.search_suggestions | 12 | 搜索框联想词:按关键词取小红书搜索框里输入这个词时给的联想词(下拉补全),按小红书列出的顺序排,一次约 10 个。 | keyword | – |
xiaohongshu.video_detail | 12 | 视频笔记详情(视频地址和字幕):按笔记编号或链接取一篇小红书视频笔记。 | id、url 里给一个 | – |
xiaohongshu.kol_follower_history | 24 | 蒲公英博主粉丝趋势:按蒲公英博主编号取这位小红书博主最近 30 天或 60 天每天的粉丝数,以及这段时间净增多少、涨了百分之几。 | id | window |
xiaohongshu.kol_similar | 24 | 蒲公英相似博主:给一个蒲公英博主编号,取蒲公英推荐的和他相似的小红书博主。 | id | – |
xiaohongshu.kol_trending_notes | 24 | 蒲公英内容广场热门笔记:取蒲公英内容广场的热门笔记榜。 | – | board、query、window、type |
xiaohongshu.kol_costs | 24 | 蒲公英博主合作成本和数据概览:按蒲公英博主编号取这位小红书博主的合作成本。 | id | tab |
xiaohongshu.kol_cost_history | 24 | 蒲公英博主核心数据趋势:按蒲公英博主编号取这位小红书博主最近 30 天或 90 天每天的核心数据。 | id | window、tab |
xiaohongshu.kol_follower_quality | 24 | 蒲公英博主粉丝概览:按蒲公英博主编号取这位小红书博主粉丝的质量。 | id | – |
xiaohongshu.kol_note_metrics | 24 | 蒲公英笔记数据:按笔记编号取蒲公英给品牌看的这篇小红书笔记的数据。 | id | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见小红书页。
抖音
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
douyin.kol_search | 3 | 星图达人搜索:按昵称里的词搜索星图上的抖音达人,可按粉丝数、预期 CPM(元)、性别筛选,按预期 CPM 从低到高排。 | query | followers_min、followers_max、cpm_min、cpm_max、gender、sort |
douyin.kol_profile | 3 | 星图达人资料:按星图达人编号取这位抖音达人在星图上的资料。 | id 里给一个 | – |
douyin.kol_audience | 3 | 星图达人粉丝画像:按星图达人编号取这位抖音达人的粉丝画像。 | id | – |
douyin.kol_performance | 3 | 星图达人传播数据:按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据。 | id | window |
douyin.brand_radar | 2 | 巨量算数品牌指数对比:按品牌名和起止日期,取这个品牌在抖音上搜索指数、内容指数、传播指数的日均值(巨量算数),并带同行业全部品牌和前 3、5、10、15、30 名品牌的均值作参照。 | brand、since、until | – |
douyin.account_history | 2 | 达人互动与粉丝趋势:按抖音账号的数字编号取最近 7 天或 30 天的变化(巨量算数)。 | id 里给一个 | window |
douyin.video_stats | 2 | 视频播放量:按视频编号取一条抖音视频此刻的数字。 | id、url 里给一个 | – |
douyin.related_videos | 2 | 相关视频:按视频编号取抖音在这条视频旁边推荐的一批相关视频。 | id | – |
douyin.hashtag_videos | 2 | 话题视频:按话题编号取一页带这个话题的抖音视频,可按综合、最多点赞或最新发布排序。 | id | sort |
douyin.keyword_audience | 2 | 巨量算数关键词人群画像:按关键词和起止日期,取抖音上关注这个词的人群画像(巨量算数)。 | keyword、since、until | – |
douyin.keyword_history | 4 | 巨量算数关键词热度趋势:按一个关键词或一次 1 到 5 个关键词,加起止日期,取每个词在抖音上逐日的搜索指数和综合指数(巨量算数,也就是抖音指数),带本期、上期和去年同期的日均值。 | since、until、keyword、keywords 里给一个 | – |
douyin.kol_rates | 24 | 星图达人商业报价:按星图达人编号取这位达人各种合作形式的报价和结算方式。 | id | – |
douyin.kol_videos | 3 | 星图达人作品表现:按星图达人编号取一页这位抖音达人的视频,从新到旧,带星图给的表现数据。 | id | – |
douyin.brand_history | 2 | 巨量算数品牌指数趋势:按品牌名和起止日期,取这个品牌在抖音上逐日的搜索指数、内容指数和传播指数(巨量算数)。 | brand、since、until | – |
douyin.account_top_videos | 2 | 巨量算数达人热门视频:按抖音账号的数字编号和起止日期(最多 30 天),取巨量算数给的这个账号的热门视频,最多 20 条,按点赞数从高到低。 | id、since、until | – |
douyin.account_audience | 2 | 巨量算数达人粉丝画像:按抖音账号的数字编号取巨量算数给的粉丝画像。 | id | – |
douyin.account_metrics | 2 | 巨量算数达人核心指标:按抖音账号的数字编号取巨量算数给的达人核心指标。 | id | – |
douyin.keyword_related | 2 | 巨量算数关联词:按一个关键词取它在抖音上某一周的关联词(巨量算数)。 | keyword、until | – |
douyin.keyword_videos | 2 | 巨量算数关键词热门视频:按关键词取巨量算数给出的约 20 条高指数视频。 | query | – |
douyin.index_topics | 2 | 巨量算数实时热点:取巨量算数的实时热点榜或飙升热点榜,各约 30 条。 | – | board |
douyin.kol_keywords | 2 | 星图达人内容热词:按星图达人编号取星图从这位抖音达人少量近期视频里提出的词,约 20 个,每个带出现次数(通常只有个位数)。 | id | – |
douyin.kol_scores | 5 | 星图达人星图指数:按星图达人编号取星图给这位抖音达人打的六项指数。 | id | – |
douyin.kol_content_mix | 3 | 星图达人内容分布:按星图达人编号取这位抖音达人近期视频的内容分类分布。 | id | – |
douyin.marketing_calendar | 3 | 星图营销活动日历:按起止时间取星图营销日历上的活动。 | since、until | – |
douyin.kol_video_report | 3 | 星图视频数据报告(播放量、完播率):按视频编号或链接取星图对一条抖音视频的数据报告。 | id、url 里给一个 | – |
douyin.search_suggestions | 12 | 搜索框联想词:按关键词取抖音搜索框里输入这个词时给的联想词(下拉补全),按抖音列出的顺序排,一次约 10 个。 | keyword | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见抖音页。
微博
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
weibo.followers | 2 | 用户粉丝列表:按用户编号取一页关注该微博用户的账号,每页 20 个。 | id | – |
weibo.likers | 2 | 点赞用户:按微博编号取最近给这条微博点赞的账号,一次约 50 个。 | id、url 里给一个 | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见微博页。
公众号
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
wechat.article_stats | 12 | 文章互动数据:按文章长链接取这篇公众号文章此刻的数字。 | url | – |
wechat.account_owner | 60 | 主体信息:按公众号原始编号取它的主体(背后的公司、机构或个人)。 | id | – |
wechat.keyword_history | 60 | 微信指数:按关键词取它最近 30 天的微信指数,一天一个数。 | keyword | – |
wechat.keyword_related | 60 | 微信搜一搜推荐词:按关键词取微信搜一搜在搜索框里给的联想推荐词,按搜一搜列出的顺序排,一次约 10 个。 | keyword | – |
wechat.miniprogram_search | 60 | 微信小程序搜索:按搜索词在微信搜一搜里找小程序,取第一页(约 25 个)。 | query | – |
wechat.account_estimates | 102 | 账号搜索:按名字或关键词找公众号,最像的排前面。 | query | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见公众号页。
知乎
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
zhihu.question_answers | 2 | 问题回答:按问题编号或链接取该知乎问题下排在最前的 20 条回答。 | id、url 里给一个 | – |
zhihu.column_articles | 2 | 专栏文章列表:按专栏编号取一页知乎专栏里的文章。 | id | – |
zhihu.followers | 2 | 用户粉丝列表:按主页地址里的用户名取一页关注该知乎用户的账号,每页 20 个。 | username | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见知乎页。
视频号
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
wechat_channels.collections | 12 | 账号的合集:按视频号账号编号取这个账号公开的全部合集。 | id | – |
wechat_channels.collection_videos | 12 | 合集里的视频:按合集编号取一页视频号合集里的视频,按合集自己的顺序(从最早的开始),每页 20 条。 | id | – |
wechat_channels.video_stats | 9 | 作品互动数据:按作品编号取视频号作品最近的数字。 | id | – |
wechat_channels.live_replays | 12 | 直播回放:按视频号账号编号取它的直播回放,从新到旧,只给第一页(实测一页最多 48 条)。 | id | – |
wechat_channels.share_link | 12 | 作品分享链接:按作品编号生成一条能在微信里打开的分享链接(weixin.qq.com/sph/ 开头)。 | id | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见视频号页。
Meta 广告库
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
meta.ad_search | 2 | 广告库搜索:按关键词搜 Meta 广告库(Facebook、Instagram 等)里正在投放的广告。 | query | region、sort、type |
meta.advertiser_ads | 2 | 广告主的广告:按广告主(Facebook 主页)的编号取它在 Meta 广告库里正在投放的广告。 | id | region、sort、type |
meta.advertiser_search | 2 | 广告主搜索:按名称在 Meta 广告库里找广告主(Facebook 主页)。 | query | – |
meta.ad_detail | 2 | 广告详情:按广告库编号或链接取 Meta 广告库里的一条广告。 | id、url 里给一个 | – |
meta.ad_transcript | 2 | 广告视频字幕:按广告库编号或链接取 Meta 广告库里一条视频广告说的话,全文。 | id、url 里给一个 | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Meta 广告库页。
Google 广告透明度中心
| 价格键(即 op) | 积分 | 返回什么 | 必填 | 可选 |
|---|---|---|---|---|
google.advertiser_ads | 2 | 广告主的广告:按广告主编号取它在 Google 广告透明度中心里的广告。 | id | region、type |
google.advertiser_search | 2 | 广告主搜索:按名称在 Google 广告透明度中心找广告主。 | query | region |
google.ad_detail | 2 | 广告详情:按编号或链接取 Google 广告透明度中心里的一条广告。 | id、url 里给一个 | – |
点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Google 广告透明度中心页。
最近更新: