TikTok Search Videos

2.07 credits/call
ae_tiktok_search_videos

Search for videos using a keyword. The keyword is required. Optional parameters are offset (starting position; default 0), count (number of results; default 20), sort_type (0 for relevance, 1 for most likes; default 0), publish_time (0 for no time restriction, or 1, 7, 30, 90, or 180 days; default 0), and region (default US). A successful response contains the search result payload in data, together with response metadata. Invalid parameter values may return a validation error.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

A fixed fee of 2.07 credits applies 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.

ParameterTypeRequiredDescriptionDefault
countintegerNo数量/Number20
offsetintegerNo偏移量/Offset0
regionstringNo地区/RegionUS
keywordstringYes关键词/Keyword—
sort_typeintegerNo排序类型/Sort type0
publish_timeintegerNo发布时间/Publish time0

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_search_videos' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "count": 20,
    "keyword": "heated shawl",
    "publish_time": 90,
    "region": "US",
    "sort_type": 1
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "cursor": 20,
    "extra": {
      "logid": "20261110101008CD1EE47E37382B00A758",
      "now": 1794305409000,
      "server_stream_time": 911
    },
    "feedback_type": "video",
    "global_doodle_config": {
      "display_filter_bar": 1,
      "feedback_survey": [
        {
          "feedback_type": "video",
          "multiple_choices": [
            {}
          ]
        }
      ],
      "hide_results": false,
      "hit_dolphin": false,
      "hit_shark": true,
      "keyword": "heated shawl"
    },
    "has_more": 1,
    "log_pb": {
      "impr_id": "20261110101008CD1EE47E37382B00A758"
    }
  },
  "docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_video_search_result_api_v1_tiktok_app_v3_fetch_video_search_result_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "02c24c6f-a37d-4f47-95a1-9fc58ad6a6ec"
}

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