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.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 9.2s.
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 }}