Douyin Get All Aweme ID
Extract Douyin video IDs from up to 20 links in one request. Input: request_body is a required array of strings. Each entry can be a Douyin short link, a full video/share URL, or copied share text containing a video link. Result: The response data contains the extracted video IDs, which identify the videos for subsequent lookups. This tool extracts IDs rather than returning video details or media files. The exact result layout and handling of individual unparseable links are not specified in the documentation. Example input: {"request_body":["https://v.douyin.com/iRNBho6u/","https://www.douyin.com/video/7298145681699622182"]}
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Each call accepts a list of links. The tool extracts aweme IDs only and does not return work details or media files.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | array | Yes | 作品链接列表/Video link list | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_get_all_aweme_id' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": [
"https://v.douyin.com/HfxDDfmySEU/",
"https://v.douyin.com/qsASW4KYvsY/",
"https://v.douyin.com/p_mRgr_Xu3A/",
"https://v.douyin.com/Kenl_eJfKE0/",
"https://v.douyin.com/5lrT0qZ2cFs/",
"https://v.douyin.com/p4inAccBDqY/",
"https://v.douyin.com/smaVn_g4w_I/",
"https://v.douyin.com/4dERbRiVJc8/",
"https://v.douyin.com/g75Vhb8PaAo/",
"https://v.douyin.com/La7LbiKMTzg/",
"https://v.douyin.com/jgF79T6itl0/",
"https://v.douyin.com/PI5mYXkka40/",
"https://v.douyin.com/gD12oyCMN14/",
"https://v.douyin.com/IuEcKQco_eI/",
"https://v.douyin.com/1napyzdLwM0/",
"https://v.douyin.com/5vXWt0zvhKs/",
"https://v.douyin.com/Tc5msLKB-10/",
"https://v.douyin.com/NlhIPwkY9DE/"
]
}
}'{
"code": 200,
"data": [
"7708967257224908075"
],
"docs": "https://api.tikhub.io/#/Douyin-Web-API/get_all_aweme_id_api_v1_douyin_web_get_all_aweme_id_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": [
"https://v.douyin.com/HfxDDfmySEU/"
]
}This example shows part of the response. Copied content is valid JSON.

