TikTok Fetch Tag Post
# Retrieve posts by tag Use this tool to list posts associated with a tag. ### Inputs - `challengeID` (required, string): The tag ID. - `count` (optional, integer, default `30`): Number of posts per page. - `cursor` (optional, integer, default `0`): Pagination cursor. ### Returns A response containing the matching tag-post data when available, together with request metadata. ### Video URL note Some direct video CDN URLs in the returned data may require the returned `tt_chain_token` as a cookie: `Cookie: tt_chain_token={tt_chain_token}` If that URL still returns HTTP 403, use a returned URL beginning with `https://www.tiktok.com/aweme/v1/play/` without sending the cookie. Do not assume that every returned video URL has the same access requirements.
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.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 每页数量/Number per page | 30 |
cursor | integer | No | 翻页游标/Page cursor | 0 |
challengeID | string | Yes | Tag ID | — |
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_tiktok_fetch_tag_post' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"challengeID": "72327229",
"count": 30,
"cursor": 120
}
}'{
"code": 200,
"data": {
"cursor": "150",
"extra": {
"logid": "2026110907450434B67986C930970098E9",
"now": 1794210305000
},
"hasMore": true,
"itemList": [
{
"CategoryType": 112,
"IsHDBitrate": false,
"ShowAIGC": true,
"author": {
"avatarLarger": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/4e690f8641b36ee4417963b06db36da0~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=8f98f54d&x-expires=1794380400&x-signature=EptUKE7gQ5vuNa5zCdjtM21oaGU%3D&t=4d5b0474&ps=13740610&shp=a",
"avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/4e690f8641b36ee4417963b06db36da0~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=e4498af6&x-expires=1794380400&x-signature=X2I0CWHydCs5T1Cfgc03AecF2io%3D&t=4d5b0474&ps=13740610&shp=a5d",
"avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/4e690f8641b36ee4417963b06db36da0~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=a8574a67&x-expires=1794380400&x-signature=76vdLbxvRhhK5gwhh72ifk61EkM%3D&t=4d5b0474&ps=13740610&shp=a5d",
"commentSetting": 0,
"downloadSetting": 0,
"id": "7593845635101590530"
},
"authorStats": {
"diggCount": 591,
"followerCount": 2157,
"followingCount": 22,
"friendCount": 0,
"heart": 38200,
"heartCount": 38200
},
"authorStatsV2": {
"diggCount": "591",
"followerCount": "2157",
"followingCount": "22",
"friendCount": "0",
"heart": "38200",
"heartCount": "38200"
}
}
]
},
"docs": "https://api.tikhub.io/#/TikTok-Web-API/fetch_tag_post_api_v1_tiktok_web_fetch_tag_post_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

