Douyin search
Keyword search over Douyin (抖音).
Douyin's web keyword-search API is requires an authenticated session (it returns 2483 "请先登录"
for all guests, even with a valid request signature). To get full video/user
results, drop a logged-in Douyin web an authenticated session export into an authenticated session
(same convention as an authenticated session; the sessionid
an authenticated session is the one that matters). WITHOUT an authenticated session the endpoint degrades
to guest-accessible related search suggestions (search_mode="suggestions")
rather than failing.
The request is signed with a_bogus (ByteDance's webmssdk signature, computed
in-process) over the same direct addressing transport as the other Douyin endpoints.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/douyin-search" \ -H "Content-Type: application/json" \ -d '{ "keyword": "美食", "search_type": "general" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "keyword": "美食", "note": "Douyin web keyword search is requires an authenticated session (status 2483). No authenticated session is configured for this platform. Add a logged-in an authenticated session export there to unlock full video/user results.", "result_count": 10, "search_mode": "suggestions", "suggestions": [ { "group_id": "6752379857042150663", "source": "sug", "text": " 美食" }, { "group_id": "7470784960409441587", "source": "sug", "text": "美食推荐🌭" }, "… 8 more items in the full response" ] } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "douyin-search", "billable": true, "duration_ms": 8576 }}