SocialToAI免费开始控制台

call

POST /v1/call/{op} 调用某个平台独有的接口,比如达人报价或商品评价。op 写成“平台.名称”。目前在 12 个平台,另有 2 个广告库上开放了 102 个这样的接口。它们的返回和六个动作是同一种外层结构,失败的调用不扣。

POSThttps://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())
返回200 OK2 积分
{  "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_detail2创意中心热门广告详情:按编号取 TikTok 创意中心的一条热门广告(Top Ads)。id–
tiktok.top_ad_search2创意中心热门广告搜索:按关键词搜 TikTok 创意中心的热门广告(Top Ads)。queryregion、window、sort
tiktok.hashtag_videos2话题作品:按话题名取一页带这个话题的 TikTok 视频,每页约 20 条。id–
tiktok.product_reviews2Shop 商品评价:按商品编号取 TikTok Shop 美国站这件商品排在最前的 10 条买家评价。id–
tiktok.product_search2Shop 商品搜索:按搜索词取 TikTok Shop 美国站的商品。query–
tiktok.seller_products2Shop 店铺商品:按店铺编号取一页这家 TikTok Shop 美国站店铺在售的商品。id–
tiktok.product_detail2Shop 商品详情:按商品编号取 TikTok Shop 美国站的一件商品。id–
tiktok.ad_search2广告库搜索:按关键词或广告主名字搜 TikTok 公开广告库(欧洲地区投放的广告)。query、advertiser 里给一个–
tiktok.ad_detail2广告库广告详情:按编号或链接取 TikTok 公开广告库里的一条广告。id、url 里给一个–
tiktok.followers2用户粉丝列表:按账号名取一页关注该 TikTok 用户的账号,每页 50 个,从最新关注的开始。username–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见TikTok 页。

Instagram

价格键(即 op)积分返回什么必填可选
instagram.hashtag_posts2话题帖子:按话题名取一页带这个话题的最新 Instagram 帖子,每页约 33 条。id–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Instagram 页。

X

价格键(即 op)积分返回什么必填可选
x.community1社群资料:按社群编号取 X 社群的资料。id–
x.community_posts4社群帖子:按社群编号取一页这个 X 社群里的帖子。id–
x.list_posts2列表帖子:按列表编号取一页这个 X 列表时间线上的帖子,从最新的开始,每页约 100 条。id–
x.article2长文详情:按帖子编号取这条 X 帖子附带的长文。id–
x.quotes4帖子引用列表:按帖子编号取一页引用它的 X 帖子,可按时间或按热门排。id–
x.retweeters2帖子转推用户:按帖子编号取一页转推了这条 X 帖子的账号。id–
x.thread9帖子对话串:按对话串里任意一条帖子的编号,取这条对话串的帖子。id–
x.followers12用户粉丝列表:按账号名取一页关注该 X 用户的账号,每页最多 200 个,从最新关注的开始。username–
x.following12用户关注列表:按账号名取一页该 X 用户关注的账号,每页最多 200 个。username–
x.mentions4用户提及:按账号名取一页提及该 X 用户的帖子,从最新的开始。username–
x.community_members5社群成员:按社群编号取一页加入了这个 X 社群的账号,每页约 20 个。id–
x.list_followers5列表关注者:按列表编号取关注了这个 X 列表的账号,最多 20 个。id–
x.list_members5列表成员:按列表编号取一页这个 X 列表收录的账号,每页 20 个。id–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见X 页。

Reddit

价格键(即 op)积分返回什么必填可选
reddit.user_subreddits2用户活跃社区:按用户名取这个 Reddit 用户活跃的社区。username–
reddit.subreddit2社区资料:按社区名取 Reddit 社区的资料。id–
reddit.subreddit_posts2社区帖子:按社区名取一页该 Reddit 社区的帖子,可按热门、最新或最高分排。idsort、window

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Reddit 页。

YouTube

价格键(即 op)积分返回什么必填可选
youtube.community_posts2频道帖子:按频道编号或账号名取一页该 YouTube 频道“帖子”栏(原“社区”)里的帖子,从最新的开始。id、username 里给一个–
youtube.community_post2帖子详情:按帖子编号或链接取一条 YouTube 频道帖子(原“社区”帖)。id、url 里给一个–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见YouTube 页。

LinkedIn

价格键(即 op)积分返回什么必填可选
linkedin.ad_detail2广告详情:按编号或链接取 LinkedIn 广告库里的一条广告。id、url 里给一个–
linkedin.ad_search2广告库搜索:按关键词或公司名搜 LinkedIn 广告库里的广告。query、advertiser 里给一个region

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见LinkedIn 页。

小红书

价格键(即 op)积分返回什么必填可选
xiaohongshu.kol_search24蒲公英博主搜索:按搜索词找蒲公英上的小红书博主(按博主写的内容匹配)。–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_profile24蒲公英博主详情:按蒲公英博主编号取这位小红书博主在蒲公英上的资料。id–
xiaohongshu.kol_audience24蒲公英博主粉丝画像:按蒲公英博主编号取这位小红书博主的粉丝画像。id–
xiaohongshu.kol_performance24蒲公英博主数据表现:按蒲公英博主编号取这位小红书博主近 30 天或 90 天日常笔记或合作笔记的数据表现。idwindow、tab
xiaohongshu.keyword_history24蒲公英关键词逐日搜索指数:按一个关键词取它在小红书上最近约三个月逐日的搜索指数(蒲公英),并带每天和这个词有关的笔记数、曝光数、阅读数和互动数。keyword–
xiaohongshu.product_search12商品搜索:按搜索词取一页小红书商城的商品。query–
xiaohongshu.product_detail12商品详情:按商品编号取小红书商城的一件商品。id–
xiaohongshu.product_reviews12商品评价:按商品编号取小红书商城这件商品排在最前的一页买家评价。id–
xiaohongshu.kol_notes24蒲公英博主笔记:按蒲公英博主编号取一页这位小红书博主的笔记(蒲公英的“笔记案例”),带蒲公英给的数据。idtab、type、sort、traffic、feature_tag、category
xiaohongshu.topic_notes12话题笔记:按话题页编号取该话题下的热门笔记。id–
xiaohongshu.keyword_related24蒲公英关联词:按一个关键词取小红书用户搜它之前和之后还会搜的词(蒲公英),各带相关度名次、搜索指数、相关笔记数和阅读数,用来拓词选题。keyword–
xiaohongshu.topic12话题详情:按话题页编号取一个小红书话题。id–
xiaohongshu.search_suggestions12搜索框联想词:按关键词取小红书搜索框里输入这个词时给的联想词(下拉补全),按小红书列出的顺序排,一次约 10 个。keyword–
xiaohongshu.video_detail12视频笔记详情(视频地址和字幕):按笔记编号或链接取一篇小红书视频笔记。id、url 里给一个–
xiaohongshu.kol_follower_history24蒲公英博主粉丝趋势:按蒲公英博主编号取这位小红书博主最近 30 天或 60 天每天的粉丝数,以及这段时间净增多少、涨了百分之几。idwindow
xiaohongshu.kol_similar24蒲公英相似博主:给一个蒲公英博主编号,取蒲公英推荐的和他相似的小红书博主。id–
xiaohongshu.kol_trending_notes24蒲公英内容广场热门笔记:取蒲公英内容广场的热门笔记榜。–board、query、window、type
xiaohongshu.kol_costs24蒲公英博主合作成本和数据概览:按蒲公英博主编号取这位小红书博主的合作成本。idtab
xiaohongshu.kol_cost_history24蒲公英博主核心数据趋势:按蒲公英博主编号取这位小红书博主最近 30 天或 90 天每天的核心数据。idwindow、tab
xiaohongshu.kol_follower_quality24蒲公英博主粉丝概览:按蒲公英博主编号取这位小红书博主粉丝的质量。id–
xiaohongshu.kol_note_metrics24蒲公英笔记数据:按笔记编号取蒲公英给品牌看的这篇小红书笔记的数据。id–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见小红书页。

抖音

价格键(即 op)积分返回什么必填可选
douyin.kol_search3星图达人搜索:按昵称里的词搜索星图上的抖音达人,可按粉丝数、预期 CPM(元)、性别筛选,按预期 CPM 从低到高排。queryfollowers_min、followers_max、cpm_min、cpm_max、gender、sort
douyin.kol_profile3星图达人资料:按星图达人编号取这位抖音达人在星图上的资料。id 里给一个–
douyin.kol_audience3星图达人粉丝画像:按星图达人编号取这位抖音达人的粉丝画像。id–
douyin.kol_performance3星图达人传播数据:按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据。idwindow
douyin.brand_radar2巨量算数品牌指数对比:按品牌名和起止日期,取这个品牌在抖音上搜索指数、内容指数、传播指数的日均值(巨量算数),并带同行业全部品牌和前 3、5、10、15、30 名品牌的均值作参照。brand、since、until–
douyin.account_history2达人互动与粉丝趋势:按抖音账号的数字编号取最近 7 天或 30 天的变化(巨量算数)。id 里给一个window
douyin.video_stats2视频播放量:按视频编号取一条抖音视频此刻的数字。id、url 里给一个–
douyin.related_videos2相关视频:按视频编号取抖音在这条视频旁边推荐的一批相关视频。id–
douyin.hashtag_videos2话题视频:按话题编号取一页带这个话题的抖音视频,可按综合、最多点赞或最新发布排序。idsort
douyin.keyword_audience2巨量算数关键词人群画像:按关键词和起止日期,取抖音上关注这个词的人群画像(巨量算数)。keyword、since、until–
douyin.keyword_history4巨量算数关键词热度趋势:按一个关键词或一次 1 到 5 个关键词,加起止日期,取每个词在抖音上逐日的搜索指数和综合指数(巨量算数,也就是抖音指数),带本期、上期和去年同期的日均值。since、until、keyword、keywords 里给一个–
douyin.kol_rates24星图达人商业报价:按星图达人编号取这位达人各种合作形式的报价和结算方式。id–
douyin.kol_videos3星图达人作品表现:按星图达人编号取一页这位抖音达人的视频,从新到旧,带星图给的表现数据。id–
douyin.brand_history2巨量算数品牌指数趋势:按品牌名和起止日期,取这个品牌在抖音上逐日的搜索指数、内容指数和传播指数(巨量算数)。brand、since、until–
douyin.account_top_videos2巨量算数达人热门视频:按抖音账号的数字编号和起止日期(最多 30 天),取巨量算数给的这个账号的热门视频,最多 20 条,按点赞数从高到低。id、since、until–
douyin.account_audience2巨量算数达人粉丝画像:按抖音账号的数字编号取巨量算数给的粉丝画像。id–
douyin.account_metrics2巨量算数达人核心指标:按抖音账号的数字编号取巨量算数给的达人核心指标。id–
douyin.keyword_related2巨量算数关联词:按一个关键词取它在抖音上某一周的关联词(巨量算数)。keyword、until–
douyin.keyword_videos2巨量算数关键词热门视频:按关键词取巨量算数给出的约 20 条高指数视频。query–
douyin.index_topics2巨量算数实时热点:取巨量算数的实时热点榜或飙升热点榜,各约 30 条。–board
douyin.kol_keywords2星图达人内容热词:按星图达人编号取星图从这位抖音达人少量近期视频里提出的词,约 20 个,每个带出现次数(通常只有个位数)。id–
douyin.kol_scores5星图达人星图指数:按星图达人编号取星图给这位抖音达人打的六项指数。id–
douyin.kol_content_mix3星图达人内容分布:按星图达人编号取这位抖音达人近期视频的内容分类分布。id–
douyin.marketing_calendar3星图营销活动日历:按起止时间取星图营销日历上的活动。since、until–
douyin.kol_video_report3星图视频数据报告(播放量、完播率):按视频编号或链接取星图对一条抖音视频的数据报告。id、url 里给一个–
douyin.search_suggestions12搜索框联想词:按关键词取抖音搜索框里输入这个词时给的联想词(下拉补全),按抖音列出的顺序排,一次约 10 个。keyword–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见抖音页。

微博

价格键(即 op)积分返回什么必填可选
weibo.followers2用户粉丝列表:按用户编号取一页关注该微博用户的账号,每页 20 个。id–
weibo.likers2点赞用户:按微博编号取最近给这条微博点赞的账号,一次约 50 个。id、url 里给一个–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见微博页。

公众号

价格键(即 op)积分返回什么必填可选
wechat.article_stats12文章互动数据:按文章长链接取这篇公众号文章此刻的数字。url–
wechat.account_owner60主体信息:按公众号原始编号取它的主体(背后的公司、机构或个人)。id–
wechat.keyword_history60微信指数:按关键词取它最近 30 天的微信指数,一天一个数。keyword–
wechat.keyword_related60微信搜一搜推荐词:按关键词取微信搜一搜在搜索框里给的联想推荐词,按搜一搜列出的顺序排,一次约 10 个。keyword–
wechat.miniprogram_search60微信小程序搜索:按搜索词在微信搜一搜里找小程序,取第一页(约 25 个)。query–
wechat.account_estimates102账号搜索:按名字或关键词找公众号,最像的排前面。query–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见公众号页。

知乎

价格键(即 op)积分返回什么必填可选
zhihu.question_answers2问题回答:按问题编号或链接取该知乎问题下排在最前的 20 条回答。id、url 里给一个–
zhihu.column_articles2专栏文章列表:按专栏编号取一页知乎专栏里的文章。id–
zhihu.followers2用户粉丝列表:按主页地址里的用户名取一页关注该知乎用户的账号,每页 20 个。username–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见知乎页。

视频号

价格键(即 op)积分返回什么必填可选
wechat_channels.collections12账号的合集:按视频号账号编号取这个账号公开的全部合集。id–
wechat_channels.collection_videos12合集里的视频:按合集编号取一页视频号合集里的视频,按合集自己的顺序(从最早的开始),每页 20 条。id–
wechat_channels.video_stats9作品互动数据:按作品编号取视频号作品最近的数字。id–
wechat_channels.live_replays12直播回放:按视频号账号编号取它的直播回放,从新到旧,只给第一页(实测一页最多 48 条)。id–
wechat_channels.share_link12作品分享链接:按作品编号生成一条能在微信里打开的分享链接(weixin.qq.com/sph/ 开头)。id–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见视频号页。

Meta 广告库

价格键(即 op)积分返回什么必填可选
meta.ad_search2广告库搜索:按关键词搜 Meta 广告库(Facebook、Instagram 等)里正在投放的广告。queryregion、sort、type
meta.advertiser_ads2广告主的广告:按广告主(Facebook 主页)的编号取它在 Meta 广告库里正在投放的广告。idregion、sort、type
meta.advertiser_search2广告主搜索:按名称在 Meta 广告库里找广告主(Facebook 主页)。query–
meta.ad_detail2广告详情:按广告库编号或链接取 Meta 广告库里的一条广告。id、url 里给一个–
meta.ad_transcript2广告视频字幕:按广告库编号或链接取 Meta 广告库里一条视频广告说的话,全文。id、url 里给一个–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Meta 广告库页。

Google 广告透明度中心

价格键(即 op)积分返回什么必填可选
google.advertiser_ads2广告主的广告:按广告主编号取它在 Google 广告透明度中心里的广告。idregion、type
google.advertiser_search2广告主搜索:按名称在 Google 广告透明度中心找广告主。queryregion
google.ad_detail2广告详情:按编号或链接取 Google 广告透明度中心里的一条广告。id、url 里给一个–

点接口名进入它自己的页面,上面有参数、返回字段和示例;全部接口见Google 广告透明度中心页。

最近更新: