POST /v1/data/douyin/search/run
Pricing: $0.0065 per video ($6.50 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Example
curl -X POST "https://api.mindcase.co/v1/data/douyin/search/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"queries": [
"人民日报",
"螺蛳粉",
"Tesla Model Y"
],
"maxResults": 10
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/douyin/search/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"queries": [
"人民日报",
"螺蛳粉",
"Tesla Model Y"
],
"maxResults": 10
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/douyin/search/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"queries": [
"人民日报",
"螺蛳粉",
"Tesla Model Y"
],
"maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one video, keyed by these fields.
| Field | Name | Type |
|---|---|---|
postUrl | Post URL | url |
caption | Caption | text |
author | Author | object |
postedDate | Posted Date | date |
views | Views | number |
likes | Likes | number |
comments | Comments | number |
shares | Shares | number |
saves | Saves | number |
language | Language | text |
isSlideshow | Is Slideshow | boolean |
isAd | Is Ad | boolean |
hashtags | Hashtags | object_array |
categories | Categories | object_array |
slideshowImages | Slideshow Images | object_array |
thumbnail | Thumbnail | image |
durationS | Duration S | number |
resolution | Resolution | text |
sound | Sound | object |
location | Location | text |
place | Place | object |
series | Series | object |
sourceQuery | Source Query | text |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "douyin/search",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"isSlideshow": true,
"author": {
"id": "3984263697677863",
"secUid": "MS4wLjABAAAA7Txq4G03B5u-0uwvSinuhKYj_o5x6vrHLqYXE5MnkWO5623gHW6QBXGyStkBsi8e",
"name": "严杰涛",
"username": "80512866354",
"signature": "加入抖音了",
"verified": false,
"verifyType": 1,
"customVerifyText": null,
"enterpriseVerifyReason": null,
"avatarThumb": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813_osUAIBALWIA1G7AAJKBievQYMYiFGemEGelVjJ.jpeg?card_type=303&column_n=0&from=327834062",
"avatarMedium": "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-i-0813_osUAIBALWIA1G7AAJKBievQYMYiFGemEGelVjJ.jpeg?from=327834062",
"avatarLarge": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813_osUAIBALWIA1G7AAJKBievQYMYiFGemEGelVjJ.jpeg?from=327834062",
"language": "zh-Hans",
"country": "CN",
"isLiving": false,
"roomId": null,
"isStar": false,
"withShopEntry": false,
"commerceUserLevel": 0,
"profileUrl": "https://www.douyin.com/user/MS4wLjABAAAA7Txq4G03B5u-0uwvSinuhKYj_o5x6vrHLqYXE5MnkWO5623gHW6QBXGyStkBsi8e"
},
"resolution": "default",
"slideshowImages": [
"https://p3-sign.douyinpic.com/tos-cn-i-0813c000-ce/o0FCA7B5pnMQxA7ADIvAtu3aAuEGEAsiPiaca~tplv-dy-aweme-images-v2:1440:2856:q80.jpeg?lk3s=138a59ce&x-expires=1..."
],
"saves": 0,
"sound": {
"id": "7697574155041999631",
"title": "@小泉(关注=点 评 穿女装)创作的原声",
"author": "小泉(关注=点 评 穿女装)",
"album": null,
"isOriginal": true,
"isCommerce": false,
"duration": 29,
"ownerId": "1860820197970056",
"ownerHandle": "s999999d6666666",
"ownerNickname": "小泉(关注=点 评 穿女装)",
"secUid": "MS4wLjABAAAAaAOQ9bHC-VaW8V6FugF4gOrTt4xCgfG3wUYQZtJEfAUT3S9vuDFmT4JtzUmXVHsZ",
"playUrl": "https://lf3-music-east.douyinstatic.com/obj/ies-music-hj/7697574216320699195.mp3",
"coverThumb": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_e37174d2244d46a0b0817a0ad319019f.jpeg?from=327834062",
"coverLarge": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_e37174d2244d46a0b0817a0ad319019f.jpeg?from=327834062",
"userCount": 0,
"collectCount": 0
},
"language": "un",
"postedDate": "2026-11-01T10:56:33Z",
"shares": 0,
"postUrl": "https://www.douyin.com/video/7703155237960576890",
"likes": 0,
"series": null,
"views": 12,
"comments": 0,
"isAd": false,
"location": "广西",
"categories": [],
"sourceQuery": "人民日报",
"thumbnail": "https://p26-sign.douyinpic.com/tos-cn-i-0813c000-ce/o0FCA7B5pnMQxA7ADIvAtu3aAuEGEAsiPiaca~noop.jpeg?biz_tag=aweme_images&card_type=303&column_n=0&from=327834...",
"hashtags": [],
"place": null,
"durationS": null,
"caption": null
}
]
}