TikTok Video Search From Name

1.05 credits/call
ae_tiktok_video_search_from_name

Search TikTok shopping videos by title keyword (fuzzy match), product ID, shop ID, brand name, creator ID, or tags. Select query_type 1–6 respectively and enter the matching value in name; separate multiple tags with commas. Choose a supported site and use page to browse results (default: 1). Specify the query mode explicitly, because the schema default of 0 has no confirmed meaning. The number of results per page and individual response fields are not guaranteed by the available documentation.

VideoSocial
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.05 credits/call

Each call is charged 1.05 AE credits.

The same charge applies to searches by title keyword, product, shop, brand, creator, or tag. Retrieving another page requires a separate call, charged individually.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
namestringNoQuery keyword; the content varies by QueryType: QueryType=1 (by title): shopping video title keyword, example: zip up jacket; QueryType=2 (by product): product ID, queries shopping videos related to the product, example: 1729396594741908129; QueryType=3 (by seller): shop ID, queries shopping videos related to this seller, example: 7495830785034323995; QueryType=4 (by brand): brand name, queries shopping videos related to the brand, example: medicube; QueryType=5 (by creator): creator ID, queries shopping videos posted by this creator, example: diegolinkk; QueryType=6 (by tag): video tag name, queries shopping videos containing the tag; multiple tags supported, separated by commas, example: #SummerFashion,#tiktokshop.—
pageintegerNoPagination, up to 100 items per page, default 1. Example: 1.1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
query_typeintegerNoQuery mode: 1=by title (default, fuzzy match), 2=by product, 3=by seller, 4=by brand, 5=by creator, 6=by tag. Example: 1.0

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_video_search_from_name' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "name": "ฝาครอบกุญแจ PCX",
    "page": 1,
    "query_type": 1,
    "site": "TH"
  }
}'
Response exampleresponse.json
JSON
"TikTok platform author are only supported on the US sites."

Guides using this tool

See how this tool fits into real workflows