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.

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

{  "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}

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

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.

Instagram

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.

X

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.

Reddit

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.

YouTube

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.

LinkedIn

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.

Xiaohongshu

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.

Douyin

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.

Weibo

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.

WeChat Articles

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.

Zhihu

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.

WeChat Channels

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.

Meta Ad Library

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.

Google Ads Transparency

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.

Last updated: 2026-10-17