TikTok Fetch Tag Post

2.07 credits/call
ae_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.

SocialVideo
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
countintegerNo每页数量/Number per page30
cursorintegerNo翻页游标/Page cursor0
challengeIDstringYesTag ID—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.