SocialToAIStart freeConsole
POST/v1/call/douyin.brand_radarPreview

Douyin trend-index brand comparison API

Only on Douyin.

The Douyin trend-index brand comparison API returns 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. One call costs 2 credits ($0.004 to $0.0067 depending on the pack); failed calls are free. Last tested 2026-10-17.

Start for freeSign in to run
100 credits on sign-up, no card needed
2 creditsper call
One objectreturned per call
2026-10-17last tested
1014 Bsample response, 1 item

Last updated:

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.

Request and response

curl https://api.socialtoai.com/v1/call/douyin.brand_radar \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "brand": "泡泡玛特",    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z"  }'
import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/call/douyin.brand_radar",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "brand": "泡泡玛特",        "since": "2026-09-01T00:00:00Z",        "until": "2026-09-30T00:00:00Z",    },)print(response.json())
# Connected over MCP? Ask in plain words.Use the Douyin trend-index brand comparison interface (douyin.brand_radar) with brand: 泡泡玛特, since: 2026-09-01T00:00:00Z, until: 2026-09-30T00:00:00Z.# Your AI calls the call tool with:{  "brand": "泡泡玛特",  "since": "2026-09-01T00:00:00Z",  "until": "2026-09-30T00:00:00Z"}
Sign in to run2 creditsOpens in the Playground with these parameters after you sign in. It never runs by itself.
200 OK1014 B2 credits
{  "op": "douyin.brand_radar",  "platform": "douyin",  "status": "ok",  "items": [    {      "platform": "douyin",      "id": "泡泡玛特",      "ref": "泡泡玛特",      "approx": [],      "type": "entry",      "entry_type": "brand_metrics",      "title": "泡泡玛特",      "url": null,      "rank": null,      "heat": null,      "fields": {        "category": "母婴",        "search_index": 123594,        "content_index": 46731,        "spread_index": 77244,        "benchmarks": [          {            "scope": "top15",            "search_index": 105282,            "content_index": 57569,            "spread_index": 73644          },          {            "scope": "top3",            "search_index": 114818,            "content_index": 58925,            "spread_index": 76682          }        ]      }    }  ],  "unavailable": [],  "cost_credits": 2}
entry_type
brand_metrics
category
母婴
search_index
123594
content_index
46731
spread_index
77244

Names and text were removed from the sample; the numbers are as recorded.

Sample dataFull response

3 parameters.
All required.

Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.

NameTypeRequiredDefaultDescription
brandstringRequired—The brand's name, spelled as the index lists it
sincedatetimeRequired—The first day counted: the China-time (UTC+8) calendar day this moment falls on
untildatetimeRequired—The last day counted, read the same way; the platform publishes a day or two late

The fields of each item.
What Douyin cannot give is marked.

FieldTypeMeaning
items[].titlestringThe entry's title or name.
items[].urlstringA link that opens it; null where the platform's list has none.
items[].rankintegerPosition on a board, from 1.
items[].heatintegerThe platform's heat score.
items[].fields.categorystringThe industry the platform puts the brand in, in the platform's words.
items[].fields.search_indexintegerDaily average of the search index over the period.
items[].fields.content_indexintegerDaily average of the content index over the period.
items[].fields.spread_indexintegerDaily average of the spread index over the period.
items[].fields.benchmarksarrayBenchmarks from the same industry: the average of all its brands, and of its top brands. Each has scope, search_index, content_index, spread_index.
nullFields Douyin cannot give

Douyin gives every field of this call. Where one item lacks a value, that field is null.

Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format

What to expect.

One call returns one object, with no pages, for 2 credits.

1 call per second per key, 5 after a purchase; going over is not charged. Rate limits

A failed call costs 0 credits and is never retried on its own. Error codes

Once connected over MCP, these questions use it.

  1. 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: 2026-09-01T00:00:00Z, until: 2026-09-30T00:00:00Z).
    call {"op":"douyin.brand_radar","brand":"泡泡玛特","since":"2026-09-01T00:00:00Z","until":"2026-09-30T00:00:00Z"}
    2 credits

Questions.
Short answers.

Everything on Douyin
Do I need a Douyin account or Douyin's own API access?
No. You only need a SocialToAI key. The call returns content and account information publicly visible on Douyin; you never sign in to Douyin or apply for anything there.
What does “Preview” mean here?
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.

Your AI is one URL away
from all of social media.

Start for freeDocs

100 credits on sign-up, no card needed