TikTok Fetch General Search

2.07 credits/call
ae_tiktok_fetch_general_search

Searches for a general list of content matching a keyword. Inputs: - `keyword` (required): Search term. - `offset` (optional, default `0`): Pagination cursor. Use the value returned by the previous response when requesting another page. - `search_id` (optional, default empty): Pagination identifier. For a subsequent page, use the identifier from the previous response, such as `data.extra.logid` or `data.log_pb.impr_id` when present. - `cookie` (optional): Provide a user cookie only when needed for account-based searching or when access requires it. Returns the general search result data, including any result metadata and available video links. Access to some returned video CDN links may require the token information included in the response; follow the response's access instructions.

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
cookiestringNo用户cookie(按需提供)/User cookie(if needed)—
offsetintegerNo翻页游标/Page cursor0
keywordstringYes搜索关键词/Search keyword—
search_idstringNo搜索id,翻页时需要提供/Search id, need to provide when paging""

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_general_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "閃光海報"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "detail": {
    "code": 400,
    "docs": "https://api.tikhub.io/#/TikTok-Web-API/fetch_general_search_api_v1_tiktok_web_fetch_general_search_get",
    "headers": {},
    "message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
    "message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
    "params": {
      "keyword": "閃光海報",
      "offset": "0",
      "search_id": ""
    }
  }
}

This example shows part of the response. Copied content is valid JSON.