SocialToAI免费开始控制台

call

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

POSThttps://api.socialtoai.com/v1/call/{op}

请求

op 写在路径里，参数放在 JSON 请求体里。max_cost_credits 和 Idempotency-Key 的用法和其他计费调用一样。

curl https://api.socialtoai.com/v1/call/tiktok.top_ad_detail \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "id": "7686210433094729735"  }'
import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/call/tiktok.top_ad_detail",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    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": [],      "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 积分，余额 98 积分"  },  "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–
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.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

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见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 广告库里的广告。queryregion

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

小红书

价格键（即 op）积分返回什么必填可选
xiaohongshu.product_search12商品搜索 (预览)：按搜索词取一页小红书商城的商品。query–
xiaohongshu.product_detail12商品详情 (预览)：按商品编号取小红书商城的一件商品。id–
xiaohongshu.product_reviews12商品评价 (预览)：按商品编号取小红书商城这件商品排在最前的一页买家评价。id–
xiaohongshu.topic_notes12话题笔记：按话题页编号取该话题下的热门笔记。id–
xiaohongshu.topic12话题详情 (预览)：按话题页编号取一个小红书话题。id–

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

抖音

价格键（即 op）积分返回什么必填可选
douyin.kol_search3星图达人搜索 (预览)：按昵称里的词搜索星图上的抖音达人。query–
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–
douyin.related_videos2相关视频：按视频编号取抖音在这条视频旁边推荐的一批相关视频。id–
douyin.hashtag_videos2话题视频：按话题编号取一页带这个话题的抖音视频。id–
douyin.keyword_audience2巨量算数关键词人群画像 (预览)：按关键词和起止日期，取抖音上关注这个词的人群画像（巨量算数）。keyword、since、until–
douyin.keyword_history4巨量算数关键词热度趋势 (预览)：按一个关键词，加起止日期，取每个词在抖音上逐日的搜索指数和综合指数（巨量算数，也就是抖音指数），带本期、上期和去年同期的日均值。since、until、keyword 里给一个–
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–

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

微博

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

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

公众号

价格键（即 op）积分返回什么必填可选
wechat.article_stats12文章互动数据：按文章长链接取这篇公众号文章此刻的数字。url–

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

知乎

价格键（即 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–

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

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 广告库页。

Google 广告透明度中心

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

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

最近更新：