# call

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

- 页面：https://socialtoai.com/zh/docs/api/call/
- 最近更新：2026-10-17

- POST: `https://api.socialtoai.com/v1/call/{op}`

## 请求

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

**cURL**

```
curl https://api.socialtoai.com/v1/call/tiktok.top_ad_detail \
  -H "Authorization: Bearer $SOCIALTOAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "7686210433094729735"
  }'
```

**Python**

```
import os
import requests

response = 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 OK, 2 积分)

```
{
  "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_detail` | 2 | [创意中心热门广告详情](https://socialtoai.com/zh/tiktok-top-ad-detail-api.md) (预览)：按编号取 TikTok 创意中心的一条热门广告（Top Ads）。 | `id` | – |
| `tiktok.top_ad_search` | 2 | [创意中心热门广告搜索](https://socialtoai.com/zh/tiktok-top-ad-search-api.md) (预览)：按关键词搜 TikTok 创意中心的热门广告（Top Ads）。 | `query` | `region`、`window`、`sort` |
| `tiktok.hashtag_videos` | 2 | [话题作品](https://socialtoai.com/zh/tiktok-hashtag-videos-api.md)：按话题名取一页带这个话题的 TikTok 视频，每页约 20 条。 | `id` | – |
| `tiktok.product_reviews` | 2 | [Shop 商品评价](https://socialtoai.com/zh/tiktok-product-reviews-api.md) (预览)：按商品编号取 TikTok Shop 美国站这件商品排在最前的 10 条买家评价。 | `id` | – |
| `tiktok.product_search` | 2 | [Shop 商品搜索](https://socialtoai.com/zh/tiktok-product-search-api.md) (预览)：按搜索词取 TikTok Shop 美国站的商品。 | `query` | – |
| `tiktok.seller_products` | 2 | [Shop 店铺商品](https://socialtoai.com/zh/tiktok-seller-products-api.md) (预览)：按店铺编号取一页这家 TikTok Shop 美国站店铺在售的商品。 | `id` | – |
| `tiktok.product_detail` | 2 | [Shop 商品详情](https://socialtoai.com/zh/tiktok-product-detail-api.md) (预览)：按商品编号取 TikTok Shop 美国站的一件商品。 | `id` | – |
| `tiktok.ad_search` | 2 | [广告库搜索](https://socialtoai.com/zh/tiktok-ad-search-api.md) (预览)：按关键词搜 TikTok 公开广告库（欧洲地区投放的广告）。 | `query` | – |
| `tiktok.ad_detail` | 2 | [广告库广告详情](https://socialtoai.com/zh/tiktok-ad-detail-api.md) (预览)：按编号或链接取 TikTok 公开广告库里的一条广告。 | `id`、`url` 里给一个 | – |
| `tiktok.followers` | 2 | [用户粉丝列表](https://socialtoai.com/zh/tiktok-followers-api.md)：按账号名取一页关注该 TikTok 用户的账号，每页 50 个，从最新关注的开始。 | `username` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[TikTok 页](https://socialtoai.com/zh/platforms/tiktok.md)。

### Instagram

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `instagram.hashtag_posts` | 2 | [话题帖子](https://socialtoai.com/zh/instagram-hashtag-posts-api.md)：按话题名取一页带这个话题的最新 Instagram 帖子，每页约 33 条。 | `id` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[Instagram 页](https://socialtoai.com/zh/platforms/instagram.md)。

### X

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `x.community` | 1 | [社群资料](https://socialtoai.com/zh/x-community-api.md) (预览)：按社群编号取 X 社群的资料。 | `id` | – |
| `x.community_posts` | 4 | [社群帖子](https://socialtoai.com/zh/x-community-posts-api.md)：按社群编号取一页这个 X 社群里的帖子。 | `id` | – |
| `x.list_posts` | 2 | [列表帖子](https://socialtoai.com/zh/x-list-posts-api.md)：按列表编号取一页这个 X 列表时间线上的帖子，从最新的开始，每页约 100 条。 | `id` | – |
| `x.article` | 2 | [长文详情](https://socialtoai.com/zh/x-article-api.md)：按帖子编号取这条 X 帖子附带的长文。 | `id` | – |
| `x.quotes` | 4 | [帖子引用列表](https://socialtoai.com/zh/x-quotes-api.md)：按帖子编号取一页引用它的 X 帖子，可按时间或按热门排。 | `id` | – |
| `x.thread` | 9 | [帖子对话串](https://socialtoai.com/zh/x-thread-api.md)：按对话串里任意一条帖子的编号，取这条对话串的帖子。 | `id` | – |
| `x.followers` | 12 | [用户粉丝列表](https://socialtoai.com/zh/x-followers-api.md)：按账号名取一页关注该 X 用户的账号，每页最多 200 个，从最新关注的开始。 | `username` | – |
| `x.following` | 12 | [用户关注列表](https://socialtoai.com/zh/x-following-api.md)：按账号名取一页该 X 用户关注的账号，每页最多 200 个。 | `username` | – |
| `x.mentions` | 4 | [用户提及](https://socialtoai.com/zh/x-mentions-api.md)：按账号名取一页提及该 X 用户的帖子，从最新的开始。 | `username` | – |
| `x.community_members` | 5 | [社群成员](https://socialtoai.com/zh/x-community-members-api.md)：按社群编号取一页加入了这个 X 社群的账号，每页约 20 个。 | `id` | – |
| `x.list_followers` | 5 | [列表关注者](https://socialtoai.com/zh/x-list-followers-api.md)：按列表编号取关注了这个 X 列表的账号，最多 20 个。 | `id` | – |
| `x.list_members` | 5 | [列表成员](https://socialtoai.com/zh/x-list-members-api.md)：按列表编号取一页这个 X 列表收录的账号，每页 20 个。 | `id` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[X 页](https://socialtoai.com/zh/platforms/x.md)。

### Reddit

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `reddit.user_subreddits` | 2 | [用户活跃社区](https://socialtoai.com/zh/reddit-user-subreddits-api.md) (预览)：按用户名取这个 Reddit 用户活跃的社区。 | `username` | – |
| `reddit.subreddit` | 2 | [社区资料](https://socialtoai.com/zh/reddit-subreddit-api.md) (预览)：按社区名取 Reddit 社区的资料。 | `id` | – |
| `reddit.subreddit_posts` | 2 | [社区帖子](https://socialtoai.com/zh/reddit-subreddit-posts-api.md)：按社区名取一页该 Reddit 社区的帖子，可按热门、最新或最高分排。 | `id` | `sort` |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[Reddit 页](https://socialtoai.com/zh/platforms/reddit.md)。

### YouTube

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `youtube.community_posts` | 2 | [频道帖子](https://socialtoai.com/zh/youtube-community-posts-api.md)：按频道编号或账号名取一页该 YouTube 频道“帖子”栏（原“社区”）里的帖子，从最新的开始。 | `id`、`username` 里给一个 | – |
| `youtube.community_post` | 2 | [帖子详情](https://socialtoai.com/zh/youtube-community-post-api.md)：按帖子编号或链接取一条 YouTube 频道帖子（原“社区”帖）。 | `id`、`url` 里给一个 | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[YouTube 页](https://socialtoai.com/zh/platforms/youtube.md)。

### LinkedIn

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `linkedin.ad_detail` | 2 | [广告详情](https://socialtoai.com/zh/linkedin-ad-detail-api.md) (预览)：按编号或链接取 LinkedIn 广告库里的一条广告。 | `id`、`url` 里给一个 | – |
| `linkedin.ad_search` | 2 | [广告库搜索](https://socialtoai.com/zh/linkedin-ad-search-api.md) (预览)：按关键词搜 LinkedIn 广告库里的广告。 | `query` | `region` |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[LinkedIn 页](https://socialtoai.com/zh/platforms/linkedin.md)。

### 小红书

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `xiaohongshu.product_search` | 12 | [商品搜索](https://socialtoai.com/zh/xiaohongshu-product-search-api.md) (预览)：按搜索词取一页小红书商城的商品。 | `query` | – |
| `xiaohongshu.product_detail` | 12 | [商品详情](https://socialtoai.com/zh/xiaohongshu-product-detail-api.md) (预览)：按商品编号取小红书商城的一件商品。 | `id` | – |
| `xiaohongshu.product_reviews` | 12 | [商品评价](https://socialtoai.com/zh/xiaohongshu-product-reviews-api.md) (预览)：按商品编号取小红书商城这件商品排在最前的一页买家评价。 | `id` | – |
| `xiaohongshu.topic_notes` | 12 | [话题笔记](https://socialtoai.com/zh/xiaohongshu-topic-notes-api.md)：按话题页编号取该话题下的热门笔记。 | `id` | – |
| `xiaohongshu.topic` | 12 | [话题详情](https://socialtoai.com/zh/xiaohongshu-topic-api.md) (预览)：按话题页编号取一个小红书话题。 | `id` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[小红书页](https://socialtoai.com/zh/platforms/xiaohongshu.md)。

### 抖音

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `douyin.kol_search` | 3 | [星图达人搜索](https://socialtoai.com/zh/douyin-kol-search-api.md) (预览)：按昵称里的词搜索星图上的抖音达人。 | `query` | – |
| `douyin.kol_profile` | 3 | [星图达人资料](https://socialtoai.com/zh/douyin-kol-profile-api.md) (预览)：按星图达人编号取这位抖音达人在星图上的资料。 | `id` 里给一个 | – |
| `douyin.kol_audience` | 3 | [星图达人粉丝画像](https://socialtoai.com/zh/douyin-kol-audience-api.md) (预览)：按星图达人编号取这位抖音达人的粉丝画像。 | `id` | – |
| `douyin.kol_performance` | 3 | [星图达人传播数据](https://socialtoai.com/zh/douyin-kol-performance-api.md) (预览)：按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据。 | `id` | `window` |
| `douyin.brand_radar` | 2 | [巨量算数品牌指数对比](https://socialtoai.com/zh/douyin-brand-radar-api.md) (预览)：按品牌名和起止日期，取这个品牌在抖音上搜索指数、内容指数、传播指数的日均值（巨量算数），并带同行业全部品牌和前 3、5、10、15、30 名品牌的均值作参照。 | `brand`、`since`、`until` | – |
| `douyin.account_history` | 2 | [达人互动与粉丝趋势](https://socialtoai.com/zh/douyin-account-history-api.md) (预览)：按抖音账号的数字编号取最近 7 天或 30 天的变化（巨量算数）。 | `id` 里给一个 | `window` |
| `douyin.video_stats` | 2 | [视频播放量](https://socialtoai.com/zh/douyin-video-stats-api.md)：按视频编号取一条抖音视频此刻的数字。 | `id` | – |
| `douyin.related_videos` | 2 | [相关视频](https://socialtoai.com/zh/douyin-related-videos-api.md)：按视频编号取抖音在这条视频旁边推荐的一批相关视频。 | `id` | – |
| `douyin.hashtag_videos` | 2 | [话题视频](https://socialtoai.com/zh/douyin-hashtag-videos-api.md)：按话题编号取一页带这个话题的抖音视频。 | `id` | – |
| `douyin.keyword_audience` | 2 | [巨量算数关键词人群画像](https://socialtoai.com/zh/douyin-keyword-audience-api.md) (预览)：按关键词和起止日期，取抖音上关注这个词的人群画像（巨量算数）。 | `keyword`、`since`、`until` | – |
| `douyin.keyword_history` | 4 | [巨量算数关键词热度趋势](https://socialtoai.com/zh/douyin-keyword-history-api.md) (预览)：按一个关键词，加起止日期，取每个词在抖音上逐日的搜索指数和综合指数（巨量算数，也就是抖音指数），带本期、上期和去年同期的日均值。 | `since`、`until`、`keyword` 里给一个 | – |
| `douyin.kol_rates` | 24 | [星图达人商业报价](https://socialtoai.com/zh/douyin-kol-rates-api.md) (预览)：按星图达人编号取这位达人各种合作形式的报价和结算方式。 | `id` | – |
| `douyin.kol_videos` | 3 | [星图达人作品表现](https://socialtoai.com/zh/douyin-kol-videos-api.md) (预览)：按星图达人编号取一页这位抖音达人的视频，从新到旧，带星图给的表现数据。 | `id` | – |
| `douyin.brand_history` | 2 | [巨量算数品牌指数趋势](https://socialtoai.com/zh/douyin-brand-history-api.md) (预览)：按品牌名和起止日期，取这个品牌在抖音上逐日的搜索指数、内容指数和传播指数（巨量算数）。 | `brand`、`since`、`until` | – |
| `douyin.account_top_videos` | 2 | [巨量算数达人热门视频](https://socialtoai.com/zh/douyin-account-top-videos-api.md)：按抖音账号的数字编号和起止日期（最多 30 天），取巨量算数给的这个账号的热门视频，最多 20 条，按点赞数从高到低。 | `id`、`since`、`until` | – |
| `douyin.account_audience` | 2 | [巨量算数达人粉丝画像](https://socialtoai.com/zh/douyin-account-audience-api.md) (预览)：按抖音账号的数字编号取巨量算数给的粉丝画像。 | `id` | – |
| `douyin.account_metrics` | 2 | [巨量算数达人核心指标](https://socialtoai.com/zh/douyin-account-metrics-api.md) (预览)：按抖音账号的数字编号取巨量算数给的达人核心指标。 | `id` | – |
| `douyin.keyword_related` | 2 | [巨量算数关联词](https://socialtoai.com/zh/douyin-keyword-related-api.md) (预览)：按一个关键词取它在抖音上某一周的关联词（巨量算数）。 | `keyword`、`until` | – |
| `douyin.keyword_videos` | 2 | [巨量算数关键词热门视频](https://socialtoai.com/zh/douyin-keyword-videos-api.md)：按关键词取巨量算数给出的约 20 条高指数视频。 | `query` | – |
| `douyin.index_topics` | 2 | [巨量算数实时热点](https://socialtoai.com/zh/douyin-index-topics-api.md)：取巨量算数的实时热点榜或飙升热点榜，各约 30 条。 | – | `board` |
| `douyin.kol_keywords` | 2 | [星图达人内容热词](https://socialtoai.com/zh/douyin-kol-keywords-api.md) (预览)：按星图达人编号取这位抖音达人近期视频内容里的高频词，约 20 个，每个带平台统计到的出现次数。 | `id` | – |
| `douyin.kol_scores` | 5 | [星图达人星图指数](https://socialtoai.com/zh/douyin-kol-scores-api.md) (预览)：按星图达人编号取星图给这位抖音达人打的六项指数。 | `id` | – |
| `douyin.kol_content_mix` | 3 | [星图达人内容分布](https://socialtoai.com/zh/douyin-kol-content-mix-api.md) (预览)：按星图达人编号取这位抖音达人近期视频的内容分类分布。 | `id` | – |
| `douyin.marketing_calendar` | 3 | [星图营销活动日历](https://socialtoai.com/zh/douyin-marketing-calendar-api.md) (预览)：按起止时间取星图营销日历上的活动。 | `since`、`until` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[抖音页](https://socialtoai.com/zh/platforms/douyin.md)。

### 微博

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `weibo.followers` | 2 | [用户粉丝列表](https://socialtoai.com/zh/weibo-followers-api.md)：按用户编号取一页关注该微博用户的账号，每页 20 个。 | `id` | – |
| `weibo.likers` | 2 | [点赞用户](https://socialtoai.com/zh/weibo-likers-api.md)：按微博编号取最近给这条微博点赞的账号，一次约 50 个。 | `id` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[微博页](https://socialtoai.com/zh/platforms/weibo.md)。

### 公众号

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `wechat.article_stats` | 12 | [文章互动数据](https://socialtoai.com/zh/wechat-article-stats-api.md)：按文章长链接取这篇公众号文章此刻的数字。 | `url` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[公众号页](https://socialtoai.com/zh/platforms/wechat.md)。

### 知乎

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `zhihu.question_answers` | 2 | [问题回答](https://socialtoai.com/zh/zhihu-question-answers-api.md)：按问题编号或链接取该知乎问题下排在最前的 20 条回答。 | `id`、`url` 里给一个 | – |
| `zhihu.column_articles` | 2 | [专栏文章列表](https://socialtoai.com/zh/zhihu-column-articles-api.md)：按专栏编号取一页知乎专栏里的文章。 | `id` | – |
| `zhihu.followers` | 2 | [用户粉丝列表](https://socialtoai.com/zh/zhihu-followers-api.md)：按主页地址里的用户名取一页关注该知乎用户的账号，每页 20 个。 | `username` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[知乎页](https://socialtoai.com/zh/platforms/zhihu.md)。

### 视频号

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `wechat_channels.collections` | 12 | [账号的合集](https://socialtoai.com/zh/wechat-channels-collections-api.md) (预览)：按视频号账号编号取这个账号公开的全部合集。 | `id` | – |
| `wechat_channels.collection_videos` | 12 | [合集里的视频](https://socialtoai.com/zh/wechat-channels-collection-videos-api.md)：按合集编号取一页视频号合集里的视频，按合集自己的顺序（从最早的开始），每页 20 条。 | `id` | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[视频号页](https://socialtoai.com/zh/platforms/wechat-channels.md)。

### Meta 广告库

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `meta.ad_search` | 2 | [广告库搜索](https://socialtoai.com/zh/meta-ad-search-api.md) (预览)：按关键词搜 Meta 广告库（Facebook、Instagram 等）里正在投放的广告。 | `query` | `region`、`sort`、`type` |
| `meta.advertiser_ads` | 2 | [广告主的广告](https://socialtoai.com/zh/meta-advertiser-ads-api.md) (预览)：按广告主（Facebook 主页）的编号取它在 Meta 广告库里正在投放的广告。 | `id` | `region`、`sort`、`type` |
| `meta.advertiser_search` | 2 | [广告主搜索](https://socialtoai.com/zh/meta-advertiser-search-api.md) (预览)：按名称在 Meta 广告库里找广告主（Facebook 主页）。 | `query` | – |
| `meta.ad_detail` | 2 | [广告详情](https://socialtoai.com/zh/meta-ad-detail-api.md) (预览)：按广告库编号或链接取 Meta 广告库里的一条广告。 | `id`、`url` 里给一个 | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[Meta 广告库页](https://socialtoai.com/zh/platforms/meta.md)。

### Google 广告透明度中心

| 价格键（即 op） | 积分 | 返回什么 | 必填 | 可选 |
| --- | --- | --- | --- | --- |
| `google.advertiser_ads` | 2 | [广告主的广告](https://socialtoai.com/zh/google-advertiser-ads-api.md) (预览)：按广告主编号取它在 Google 广告透明度中心里的广告。 | `id` | `region`、`type` |
| `google.advertiser_search` | 2 | [广告主搜索](https://socialtoai.com/zh/google-advertiser-search-api.md) (预览)：按名称在 Google 广告透明度中心找广告主。 | `query` | `region` |
| `google.ad_detail` | 2 | [广告详情](https://socialtoai.com/zh/google-ad-detail-api.md) (预览)：按编号或链接取 Google 广告透明度中心里的一条广告。 | `id`、`url` 里给一个 | – |

点接口名进入它自己的页面，上面有参数、返回字段和示例；全部接口见[Google 广告透明度中心页](https://socialtoai.com/zh/platforms/google.md)。