# call

POST /v1/call/{op} runs an interface that only one platform has, such as a creator marketplace or product reviews. The op is written platform.name. 74 such interfaces are offered now, on 12 platforms plus 2 ad libraries. They answer in the same envelope as the six actions, and a call that fails costs nothing.

- Page: https://socialtoai.com/docs/api/call/
- Last updated: 2026-10-17

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

## Request

The op goes in the path and its parameters in a JSON body. `max_cost_credits` and `Idempotency-Key` work as on every billed call.

**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())
```

**Response** (200 OK, 2 credits)

```
{
  "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": "This call: 2 credits. Balance: 98 credits."
  },
  "replayed": false
}
```

_Sample data: names, links and text are replaced by placeholders._

## Interfaces

Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

### TikTok

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `tiktok.top_ad_detail` | 2 | [Creative Center Top Ad detail](https://socialtoai.com/tiktok-top-ad-detail-api.md) (Preview): Get one Top Ad of TikTok's Creative Center by its ID. | `id` | – |
| `tiktok.top_ad_search` | 2 | [Creative Center Top Ads search](https://socialtoai.com/tiktok-top-ad-search-api.md) (Preview): Search the Top Ads of TikTok's Creative Center by keyword. | `query` | `region`, `window`, `sort` |
| `tiktok.hashtag_videos` | 2 | [Hashtag videos](https://socialtoai.com/tiktok-hashtag-videos-api.md): Get a page of the TikTok videos under a hashtag, by its name, about 20 a page. | `id` | – |
| `tiktok.product_reviews` | 2 | [Shop product reviews](https://socialtoai.com/tiktok-product-reviews-api.md) (Preview): Get the first 10 buyers' reviews of a TikTok Shop product in the United States by the product's ID. | `id` | – |
| `tiktok.product_search` | 2 | [Shop product search](https://socialtoai.com/tiktok-product-search-api.md) (Preview): Search the products of TikTok Shop in the United States by terms. | `query` | – |
| `tiktok.seller_products` | 2 | [Shop seller products](https://socialtoai.com/tiktok-seller-products-api.md) (Preview): Get a page of the products a TikTok Shop seller in the United States has on sale by the seller's ID. | `id` | – |
| `tiktok.product_detail` | 2 | [Shop product detail](https://socialtoai.com/tiktok-product-detail-api.md) (Preview): Get a TikTok Shop product in the United States by its ID. | `id` | – |
| `tiktok.ad_search` | 2 | [Ads Library search](https://socialtoai.com/tiktok-ad-search-api.md) (Preview): Search TikTok's public Ads Library (ads shown in Europe) by keyword. | `query` | – |
| `tiktok.ad_detail` | 2 | [Ads Library ad detail](https://socialtoai.com/tiktok-ad-detail-api.md) (Preview): Get one ad of TikTok's public Ads Library by its ID or link. | one of `id`, `url` | – |
| `tiktok.followers` | 2 | [User followers](https://socialtoai.com/tiktok-followers-api.md): Get a page of the accounts following a TikTok user, by handle, 50 a page, newest followers first. | `username` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [TikTok page](https://socialtoai.com/platforms/tiktok.md).

### Instagram

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `instagram.hashtag_posts` | 2 | [Hashtag posts](https://socialtoai.com/instagram-hashtag-posts-api.md): Get a page of the newest Instagram posts under a hashtag, by its name, about 33 a page. | `id` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Instagram page](https://socialtoai.com/platforms/instagram.md).

### X

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `x.community` | 1 | [Community profile](https://socialtoai.com/x-community-api.md) (Preview): Get an X community by its ID. | `id` | – |
| `x.community_posts` | 4 | [Community posts](https://socialtoai.com/x-community-posts-api.md): Get a page of the posts in an X community by the community's ID. | `id` | – |
| `x.list_posts` | 2 | [List posts](https://socialtoai.com/x-list-posts-api.md): Get a page of the posts on an X list's timeline by the list's ID, newest first, about 100 a page. | `id` | – |
| `x.article` | 2 | [Article detail](https://socialtoai.com/x-article-api.md): Get the long-form article attached to an X post by the post's ID. | `id` | – |
| `x.quotes` | 4 | [Post quotes](https://socialtoai.com/x-quotes-api.md): Get a page of the X posts that quote a post, newest first or most popular first. | `id` | – |
| `x.thread` | 9 | [Thread context](https://socialtoai.com/x-thread-api.md): Get the posts of an X thread by the ID of any post in it. | `id` | – |
| `x.followers` | 12 | [User followers](https://socialtoai.com/x-followers-api.md): Get a page of the accounts following an X user, up to 200 a page, newest followers first. | `username` | – |
| `x.following` | 12 | [User following](https://socialtoai.com/x-following-api.md): Get a page of the accounts an X user follows, up to 200 a page. | `username` | – |
| `x.mentions` | 4 | [User mentions](https://socialtoai.com/x-mentions-api.md): Get a page of the posts that mention an X user, newest first. | `username` | – |
| `x.community_members` | 5 | [Community members](https://socialtoai.com/x-community-members-api.md): Get a page of the accounts that have joined an X community, by the community's ID, about 20 a page. | `id` | – |
| `x.list_followers` | 5 | [List followers](https://socialtoai.com/x-list-followers-api.md): Get accounts that follow an X list, by the list's ID, up to 20. | `id` | – |
| `x.list_members` | 5 | [List members](https://socialtoai.com/x-list-members-api.md): Get a page of the accounts an X list is made of, by the list's ID, 20 a page. | `id` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [X page](https://socialtoai.com/platforms/x.md).

### Reddit

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `reddit.user_subreddits` | 2 | [User active communities](https://socialtoai.com/reddit-user-subreddits-api.md) (Preview): Get the communities a Reddit user is active in by username. | `username` | – |
| `reddit.subreddit` | 2 | [Community profile](https://socialtoai.com/reddit-subreddit-api.md) (Preview): Get a Reddit community by its name. | `id` | – |
| `reddit.subreddit_posts` | 2 | [Community posts](https://socialtoai.com/reddit-subreddit-posts-api.md): Get a page of the posts of a Reddit community by its name, hot, newest or top score first. | `id` | `sort` |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Reddit page](https://socialtoai.com/platforms/reddit.md).

### YouTube

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `youtube.community_posts` | 2 | [Channel posts](https://socialtoai.com/youtube-community-posts-api.md): Get a page of the posts on a YouTube channel's Posts tab (once Community) by channel ID or handle, newest first. | one of `id`, `username` | – |
| `youtube.community_post` | 2 | [Post detail](https://socialtoai.com/youtube-community-post-api.md): Get one YouTube channel post (once a Community post) by ID or link. | one of `id`, `url` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [YouTube page](https://socialtoai.com/platforms/youtube.md).

### LinkedIn

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `linkedin.ad_detail` | 2 | [Ad detail](https://socialtoai.com/linkedin-ad-detail-api.md) (Preview): Get one ad of the LinkedIn Ad Library by its ID or link. | one of `id`, `url` | – |
| `linkedin.ad_search` | 2 | [Ad Library search](https://socialtoai.com/linkedin-ad-search-api.md) (Preview): Search the ads of the LinkedIn Ad Library by keyword. | `query` | `region` |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [LinkedIn page](https://socialtoai.com/platforms/linkedin.md).

### Xiaohongshu

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `xiaohongshu.product_search` | 12 | [Product search](https://socialtoai.com/xiaohongshu-product-search-api.md) (Preview): Search the products of Xiaohongshu's shop by terms. | `query` | – |
| `xiaohongshu.product_detail` | 12 | [Product detail](https://socialtoai.com/xiaohongshu-product-detail-api.md) (Preview): Get a product of Xiaohongshu's shop by its ID. | `id` | – |
| `xiaohongshu.product_reviews` | 12 | [Product reviews](https://socialtoai.com/xiaohongshu-product-reviews-api.md) (Preview): Get the first page of buyers' reviews of a product of Xiaohongshu's shop by the product's ID. | `id` | – |
| `xiaohongshu.topic_notes` | 12 | [Topic notes](https://socialtoai.com/xiaohongshu-topic-notes-api.md): Get the trending notes under a Xiaohongshu topic by its page ID. | `id` | – |
| `xiaohongshu.topic` | 12 | [Topic detail](https://socialtoai.com/xiaohongshu-topic-api.md) (Preview): Get one Xiaohongshu topic by its page ID. | `id` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Xiaohongshu page](https://socialtoai.com/platforms/xiaohongshu.md).

### Douyin

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `douyin.kol_search` | 3 | [Xingtu creator search](https://socialtoai.com/douyin-kol-search-api.md) (Preview): Search Douyin creators on Xingtu by words in their name. | `query` | – |
| `douyin.kol_profile` | 3 | [Xingtu creator profile](https://socialtoai.com/douyin-kol-profile-api.md) (Preview): Get a Douyin creator's profile on Xingtu by Xingtu creator ID. | one of `id` | – |
| `douyin.kol_audience` | 3 | [Xingtu creator audience](https://socialtoai.com/douyin-kol-audience-api.md) (Preview): Get who follows a Douyin creator, by Xingtu creator ID. | `id` | – |
| `douyin.kol_performance` | 3 | [Xingtu creator metrics](https://socialtoai.com/douyin-kol-performance-api.md) (Preview): Get how a Douyin creator's videos did over the last 30 or 90 days, by Xingtu creator ID. | `id` | `window` |
| `douyin.brand_radar` | 2 | [Trend-index brand comparison](https://socialtoai.com/douyin-brand-radar-api.md) (Preview): Get the daily averages of a brand's search, content and spread indexes on Douyin over a date range, from the platform's own index tool, with the averages of every brand in its industry and of the industry's top 3, 5, 10, 15 and 30 to hold them against. | `brand`, `since`, `until` | – |
| `douyin.account_history` | 2 | [Creator engagement and follower trends](https://socialtoai.com/douyin-account-history-api.md) (Preview): Get how a Douyin account's numbers moved over the last 7 or 30 days, by its numeric ID, from the platform's own index tool. | one of `id` | `window` |
| `douyin.video_stats` | 2 | [Video play count](https://socialtoai.com/douyin-video-stats-api.md): Get a Douyin video's counts as of now, by its ID. | `id` | – |
| `douyin.related_videos` | 2 | [Related videos](https://socialtoai.com/douyin-related-videos-api.md): Get the batch of videos Douyin recommends beside a video, by its ID. | `id` | – |
| `douyin.hashtag_videos` | 2 | [Hashtag videos](https://socialtoai.com/douyin-hashtag-videos-api.md): Get a page of Douyin videos under a hashtag, by the hashtag's ID. | `id` | – |
| `douyin.keyword_audience` | 2 | [Trend-index keyword audience](https://socialtoai.com/douyin-keyword-audience-api.md) (Preview): Get who is behind a keyword on Douyin over a date range, from the platform's own keyword tool. | `keyword`, `since`, `until` | – |
| `douyin.keyword_history` | 4 | [Trend-index keyword trends](https://socialtoai.com/douyin-keyword-history-api.md) (Preview): Get the day-by-day search index and composite index of a keyword on Douyin over a date range, from 巨量算数 (the Douyin index), with the daily averages of the period, of the one before and of a year earlier. | `since`, `until`, one of `keyword` | – |
| `douyin.kol_rates` | 24 | [Xingtu creator rate card](https://socialtoai.com/douyin-kol-rates-api.md) (Preview): Get what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled. | `id` | – |
| `douyin.kol_videos` | 3 | [Xingtu creator video performance](https://socialtoai.com/douyin-kol-videos-api.md) (Preview): Get a page of a Douyin creator's videos by Xingtu creator ID, newest first, with the figures Xingtu gives for each. | `id` | – |
| `douyin.brand_history` | 2 | [Trend-index brand trends](https://socialtoai.com/douyin-brand-history-api.md) (Preview): Get a brand's day-by-day search, content and spread indexes on Douyin over a date range, from the platform's own index tool. | `brand`, `since`, `until` | – |
| `douyin.account_top_videos` | 2 | [Trend-index creator top videos](https://socialtoai.com/douyin-account-top-videos-api.md): Get the videos the platform's own index tool lists as a Douyin account's top videos for a span of up to 30 days, by the account's numeric ID. | `id`, `since`, `until` | – |
| `douyin.account_audience` | 2 | [Trend-index creator follower profile](https://socialtoai.com/douyin-account-audience-api.md) (Preview): Get who follows a Douyin account from the platform's own index tool, by the account's numeric ID. | `id` | – |
| `douyin.account_metrics` | 2 | [Trend-index creator core metrics](https://socialtoai.com/douyin-account-metrics-api.md) (Preview): Get a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID. | `id` | – |
| `douyin.keyword_related` | 2 | [Trend-index related keywords](https://socialtoai.com/douyin-keyword-related-api.md) (Preview): Get the keywords related to a keyword on Douyin in one week, from the platform's own keyword tool. | `keyword`, `until` | – |
| `douyin.keyword_videos` | 2 | [Trend-index keyword hot videos](https://socialtoai.com/douyin-keyword-videos-api.md): Get the roughly 20 high-index videos Douyin's index tool puts forward for a keyword. | `query` | – |
| `douyin.index_topics` | 2 | [Trend-index live hot topics](https://socialtoai.com/douyin-index-topics-api.md): Get the live topic board or the fastest-rising topic board of Douyin's index tool, about 30 entries each. | – | `board` |
| `douyin.kol_keywords` | 2 | [Xingtu creator content keywords](https://socialtoai.com/douyin-kol-keywords-api.md) (Preview): Get the words a Douyin creator's recent videos keep coming back to, by Xingtu creator ID. | `id` | – |
| `douyin.kol_scores` | 5 | [Xingtu creator index scores](https://socialtoai.com/douyin-kol-scores-api.md) (Preview): Get the six scores Xingtu gives a Douyin creator, by Xingtu creator ID. | `id` | – |
| `douyin.kol_content_mix` | 3 | [Xingtu creator content mix](https://socialtoai.com/douyin-kol-content-mix-api.md) (Preview): Get what a Douyin creator's recent videos are about, by Xingtu creator ID. | `id` | – |
| `douyin.marketing_calendar` | 3 | [Xingtu marketing calendar](https://socialtoai.com/douyin-marketing-calendar-api.md) (Preview): Get the campaigns on Xingtu's marketing calendar over a span of time. | `since`, `until` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Douyin page](https://socialtoai.com/platforms/douyin.md).

### Weibo

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `weibo.followers` | 2 | [User followers](https://socialtoai.com/weibo-followers-api.md): Get a page of the accounts following a Weibo user, 20 a page. | `id` | – |
| `weibo.likers` | 2 | [Post likers](https://socialtoai.com/weibo-likers-api.md): Get the accounts that most recently liked a Weibo post by post ID, about 50 at a time. | `id` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Weibo page](https://socialtoai.com/platforms/weibo.md).

### WeChat Articles

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `wechat.article_stats` | 12 | [Official Account article stats](https://socialtoai.com/wechat-article-stats-api.md): Get the current counts of a WeChat Official Account article by its long link. | `url` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [WeChat Articles page](https://socialtoai.com/platforms/wechat.md).

### Zhihu

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `zhihu.question_answers` | 2 | [Question answers](https://socialtoai.com/zhihu-question-answers-api.md): Get the first 20 answers to a Zhihu question by ID or link, in Zhihu's own order. | one of `id`, `url` | – |
| `zhihu.column_articles` | 2 | [Column articles](https://socialtoai.com/zhihu-column-articles-api.md): Get a page of the articles in a Zhihu column by the column's ID. | `id` | – |
| `zhihu.followers` | 2 | [User followers](https://socialtoai.com/zhihu-followers-api.md): Get a page of the accounts following a Zhihu user, 20 a page. | `username` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Zhihu page](https://socialtoai.com/platforms/zhihu.md).

### WeChat Channels

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `wechat_channels.collections` | 12 | [Account collections](https://socialtoai.com/wechat-channels-collections-api.md) (Preview): Get every public collection of a WeChat Channels account by the account's ID. | `id` | – |
| `wechat_channels.collection_videos` | 12 | [Collection videos](https://socialtoai.com/wechat-channels-collection-videos-api.md): Get a page of the videos in a WeChat Channels collection by the collection's ID, in the collection's own order (oldest first), 20 a page. | `id` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [WeChat Channels page](https://socialtoai.com/platforms/wechat-channels.md).

### Meta Ad Library

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `meta.ad_search` | 2 | [Ad Library search](https://socialtoai.com/meta-ad-search-api.md) (Preview): Search the ads running now in the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword. | `query` | `region`, `sort`, `type` |
| `meta.advertiser_ads` | 2 | [Advertiser's ads](https://socialtoai.com/meta-advertiser-ads-api.md) (Preview): Get the ads an advertiser (a Facebook page) is running now in the Meta Ad Library, by the page's ID. | `id` | `region`, `sort`, `type` |
| `meta.advertiser_search` | 2 | [Advertiser search](https://socialtoai.com/meta-advertiser-search-api.md) (Preview): Find advertisers (Facebook pages) in the Meta Ad Library by name. | `query` | – |
| `meta.ad_detail` | 2 | [Ad detail](https://socialtoai.com/meta-ad-detail-api.md) (Preview): Get one ad of the Meta Ad Library by its library ID or link. | one of `id`, `url` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Meta Ad Library page](https://socialtoai.com/platforms/meta.md).

### Google Ads Transparency

| Price key (the op) | Credits | What it returns | Required | Optional |
| --- | --- | --- | --- | --- |
| `google.advertiser_ads` | 2 | [Advertiser's ads](https://socialtoai.com/google-advertiser-ads-api.md) (Preview): Get an advertiser's ads from the Google Ads Transparency Center, by the advertiser's ID. | `id` | `region`, `type` |
| `google.advertiser_search` | 2 | [Advertiser search](https://socialtoai.com/google-advertiser-search-api.md) (Preview): Find advertisers in the Google Ads Transparency Center by name. | `query` | `region` |
| `google.ad_detail` | 2 | [Ad detail](https://socialtoai.com/google-ad-detail-api.md) (Preview): Get one ad of the Google Ads Transparency Center by its ID or link. | one of `id`, `url` | – |

Each name leads to the interface's own page, with its parameters, returned fields and a sample. All of them are on the [Google Ads Transparency page](https://socialtoai.com/platforms/google.md).