Search videos
Returns videos matching a keyword, with sort, recency, duration and content-type filters.
15 credits / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
keyword*string
Search term.
Length
1 <= lengthcursor?|
Continuation cursor from the previous response (cursor/max_cursor). Omit or 0 for the first page.
Range
0 <= value <= 9007199254740991Default
0sort_type?string
0 comprehensive, 1 most liked, 2 most recent.
Default
"0"Value in
- "0"
- "1"
- "2"
publish_time?string
Age of the post in days: 0 any time, 1 last day, 7 last week, 180 last six months.
Default
"0"Value in
- "0"
- "1"
- "7"
- "180"
filter_duration?string
Video length in minutes: 0 any, 0-1 under a minute, 1-5, 5-10000 over five minutes.
Default
"0"Value in
- "0"
- "0-1"
- "1-5"
- "5-10000"
content_type?string
0 any, 1 video, 2 image/text, 3 article.
Default
"0"Value in
- "0"
- "1"
- "2"
- "3"
search_id?string
Continuation token echoed from the previous search response. Send it together with cursor to page; omit for the first page.
curl -X GET "https://example.com/v2/douyin/search/videos?keyword=%E7%8C%AB%E5%92%AA" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "aweme_list": [ { "aweme_id": "7448118827402972455" } ], "cursor": 10, "has_more": 1 }}