Douyin Topic Search
https://api.sandbase.ai/v1/api/douyin/index/topic-queryReturns Douyin topic performance metrics matching a search term over a specific date range, including item counts, like counts, and view counts.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 3 required · 1 optional
Production route
Try the model
Playground
Input
Platform Allowed values: aweme, toutiao.
End date YYYYMMDD
Topic keyword
Start date YYYYMMDD
OutputExample
[
{
"data": {
"BaseResp": {
"StatusCode": 0,
"StatusMessage": ""
},
"topic_list": [
{
"datetime": "",
"digg_cnt": "3886643",
"item_cnt": "26313",
"play_read_cnt": "201528869",
"topic_id": "1576073697445901",
"topic_index": "2729228",
"topic_name": "人工智能"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "1761040785381389",
"topic_index": "0",
"topic_name": "人工智能与就业"
},
{
"datetime": "",
"digg_cnt": "108324",
"item_cnt": "1202",
"play_read_cnt": "5712508",
"topic_id": "1607024574053384",
"topic_index": "49588",
"topic_name": "ai人工智能"
},
{
"datetime": "",
"digg_cnt": "662874",
"item_cnt": "2158",
"play_read_cnt": "13769651",
"topic_id": "1762134954404864",
"topic_index": "1181253",
"topic_name": "人工智能聊天对话"
},
{
"datetime": "",
"digg_cnt": "40411",
"item_cnt": "503",
"play_read_cnt": "3424475",
"topic_id": "1593612287325188",
"topic_index": "50262",
"topic_name": "人工智能机器人"
},
{
"datetime": "",
"digg_cnt": "2149",
"item_cnt": "81",
"play_read_cnt": "203317",
"topic_id": "1618069927538696",
"topic_index": "103",
"topic_name": "人工智能专业"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "1698531221299228",
"topic_index": "0",
"topic_name": "全国青少年人工智能创新挑战赛"
},
{
"datetime": "",
"digg_cnt": "409",
"item_cnt": "4",
"play_read_cnt": "29459",
"topic_id": "1611902089013251",
"topic_index": "4",
"topic_name": "世界人工智能大会"
},
{
"datetime": "",
"digg_cnt": "1999",
"item_cnt": "113",
"play_read_cnt": "179435",
"topic_id": "1709213980513288",
"topic_index": "147",
"topic_name": "人工智能就业"
},
{
"datetime": "",
"digg_cnt": "9294",
"item_cnt": "117",
"play_read_cnt": "1278850",
"topic_id": "1634242781984771",
"topic_index": "5750",
"topic_name": "人工智能技术"
},
{
"datetime": "",
"digg_cnt": "319",
"item_cnt": "6",
"play_read_cnt": "4615",
"topic_id": "1702717047329869",
"topic_index": "6",
"topic_name": "人工智能企业"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "7390626301490497588",
"topic_index": "0",
"topic_name": "智能机器人工作"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "7601089907280316456",
"topic_index": "0",
"topic_name": "2026世界人工智能大会"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "7550942489794381862",
"topic_index": "0",
"topic_name": "张江人工智能创新小镇"
},
{
"datetime": "",
"digg_cnt": "1100",
"item_cnt": "220",
"play_read_cnt": "167317",
"topic_id": "1624248395311117",
"topic_index": "288",
"topic_name": "人工智能培训"
},
{
"datetime": "",
"digg_cnt": "220",
"item_cnt": "1",
"play_read_cnt": "7787",
"topic_id": "7383982541302138917",
"topic_index": "1",
"topic_name": "科大讯飞人工智能科技体验展"
},
{
"datetime": "",
"digg_cnt": "7523",
"item_cnt": "312",
"play_read_cnt": "519149",
"topic_id": "1660347071960078",
"topic_index": "3610",
"topic_name": "人工智能训练师"
},
{
"datetime": "",
"digg_cnt": "7039",
"item_cnt": "467",
"play_read_cnt": "428885",
"topic_id": "1606750321838152",
"topic_index": "3015",
"topic_name": "人工智能教育"
},
{
"datetime": "",
"digg_cnt": "124",
"item_cnt": "2",
"play_read_cnt": "11549",
"topic_id": "1640173483204615",
"topic_index": "2",
"topic_name": "ai人工智能时代"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "1788749732212868",
"topic_index": "0",
"topic_name": "人工智能与人类的未来"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "1764511309803533",
"topic_index": "0",
"topic_name": "人工智能获客软件"
},
{
"datetime": "",
"digg_cnt": "187",
"item_cnt": "36",
"play_read_cnt": "17930",
"topic_id": "1729347851094094",
"topic_index": "43",
"topic_name": "人工智能应用工程师"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "7593682468294395956",
"topic_index": "0",
"topic_name": "人工智能就业新趋势"
},
{
"datetime": "",
"digg_cnt": "420",
"item_cnt": "83",
"play_read_cnt": "60887",
"topic_id": "1759491398609932",
"topic_index": "106",
"topic_name": "人工智能培训机构"
},
{
"datetime": "",
"digg_cnt": "0",
"item_cnt": "0",
"play_read_cnt": "0",
"topic_id": "1778746338615324",
"topic_index": "0",
"topic_name": "ai人工智能创作"
},
{
"datetime": "",
"digg_cnt": "294",
"item_cnt": "78",
"play_read_cnt": "23187",
"topic_id": "1790246423393280",
"topic_index": "99",
"topic_name": "人工智能考证"
},
{
"datetime": "",
"digg_cnt": "3072",
"item_cnt": "71",
"play_read_cnt": "210759",
"topic_id": "1757141278127176",
"topic_index": "90",
"topic_name": "人工智能到底会让哪些人失业"
},
{
"datetime": "",
"digg_cnt": "1746",
"item_cnt": "45",
"play_read_cnt": "163647",
"topic_id": "1725714168126542",
"topic_index": "55",
"topic_name": "人工智能证书"
},
{
"datetime": "",
"digg_cnt": "2958",
"item_cnt": "106",
"play_read_cnt": "277862",
"topic_id": "1710288587747339",
"topic_index": "937",
"topic_name": "人工智能未来"
},
{
"datetime": "",
"digg_cnt": "368",
"item_cnt": "59",
"play_read_cnt": "116156",
"topic_id": "1738692948984848",
"topic_index": "875",
"topic_name": "人工智能硕士"
},
{
"datetime": "",
"digg_cnt": "109",
"item_cnt": "24",
"play_read_cnt": "9161",
"topic_id": "7418552275003508790",
"topic_index": "27",
"topic_name": "人工智能证书怎么考"
},
{
"datetime": "",
"digg_cnt": "2327",
"item_cnt": "77",
"play_read_cnt": "118943",
"topic_id": "1740581471988739",
"topic_index": "98",
"topic_name": "人工智能训练师证书"
},
{
"datetime": "",
"digg_cnt": "3415",
"item_cnt": "70",Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- end_date
- string · required
- keyword
- string · required
- start_date
- string · required
- app_name
- string (aweme, toutiao) · optional
Access
- Provider
- Douyin
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/douyin/index/topic-query
- Authentication
- Bearer API key
API README
Douyin Topic Search API
Query topic metrics on Douyin by submitting a keyword alongside start_date and end_date date filters.
Use cases
- Track engagement and total views for specific trend topics.
- Compare topic volume across Aweme and Toutiao platforms.
- Retrieve topic identifiers for historical performance monitoring.
Request
curl -X POST "https://api.sandbase.ai/v1/api/douyin/index/topic-query" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"end_date": "20260412", "keyword": "人工智能", "start_date": "20260406"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Topic keyword |
end_date | string | Yes | End date YYYYMMDD |
start_date | string | Yes | Start date YYYYMMDD |
app_name | string | No | Platform |
Example response
Real response for the request above, trimmed to the main fields. User names and long IDs are masked.
{
"topic_list": [
{
"digg_cnt": "3886643",
"item_cnt": "26313",
"play_read_cnt": "201528869",
"topic_id": "1576073697445901",
"topic_name": "人工智能"
}
]
}
Notes
start_dateandend_datemust be formatted as YYYYMMDD.app_namefilters by platform and supportsawemeortoutiao.
Related APIs
- Douyin Index Area List: Returns the complete list of supported geographic areas available for Douyin Index queries.
- Douyin Index Valid Dates: Returns the latest valid dates available for each data type in Douyin Index.
- Douyin Brand Popularity Cycles: Returns periodic brand popularity and cycle analysis data across platforms for a specified brand name and date range.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/index/topic-query" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"keyword": "人工智能",
"app_name": "aweme",
"end_date": "20260412",
"start_date": "20260406"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
Douyin Topic SearchThis API Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the Douyin Topic Search API?
Send a POST request to https://api.sandbase.ai/v1/api/douyin/index/topic-query with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the Douyin Topic Search API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the Douyin Topic Search API accept?
Required: end_date (string), keyword (string) and start_date (string). Optional: app_name (one of aweme, toutiao). The Parameters table and the Playground on this page list every field.
What does the Douyin Topic Search API return?
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
Do I need a Douyin developer account or API key?
No. Douyin Topic Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.