Douyin Fetch Creator Material Center Related
## Purpose Get the related-video list for a hot spot, topic, prop, or music item in the Douyin creator material center. ## Inputs - `query_id` (required, string): Item identifier obtained from the relevant billboard, such as a hot-spot or topic billboard. This is an ID lookup, not a keyword search. - `billboard_type` (optional, integer): Match this to the item type: `2` = hot spot (default), `3` = topic, `4` = prop, `5` = music. - `limit` (optional, integer): Items per page, from 1 to 100; default 20. - `offset` (optional, integer): Pagination starting offset, at least 0; default 0. ## Result Returns related-video list data for the specified item and requested page. Detailed fields within the video records are not specified. ## Example `query_id="2488260", billboard_type=2, limit=20, offset=0` requests the first page of videos related to the specified hot spot.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed fee of 2.07 credits is charged per call. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
limit | integer | No | 每页数量/Items per page | 20 |
offset | integer | No | 偏移量/Offset | 0 |
query_id | string | Yes | 查询ID/Query ID (话题ID/热点ID,从其他榜单接口获取) | — |
billboard_type | integer | No | 榜单类型/Billboard type (2=热点, 3=话题, 4=道具, 5=音乐) | 2 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeyThis example shows part of the response. Copied content is valid JSON.

