TikTok Search Users

2.07 credits/call
ae_tiktok_search_users

Search for users by a required keyword. Optionally set offset and count for pagination, filter by follower-count range or verified profile type, and prioritize username relevance. The response contains search data in `data` and metadata such as status code, request parameters, timestamp, and request identifier.

Social
2.07 credits/call

Pricing

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

A fixed charge 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
keywordstringYes关键词/Keyword—
user_search_other_prefstringNo根据其他偏好排序/Sort by other preferences""
user_search_profile_typestringNo根据账号类型排序/Sort by account type""
user_search_follower_countstringNo根据粉丝数排序/Sort by number of followers""

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_users' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "count": 20,
    "keyword": "pilates toronto",
    "user_search_follower_count": "ONE_K_TO_TEN_K"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "cursor": 20,
    "extra": {
      "logid": "20261111085410FC2D3A8F7AB1C8875F80",
      "now": 1794387251000,
      "server_stream_time": 510
    },
    "feedback_type": "user",
    "global_doodle_config": {
      "ab_params": {
        "user_relation_ship": "1"
      },
      "display_filter_bar": 1,
      "feedback_survey": [
        {
          "feedback_type": "user",
          "multiple_choices": [
            {}
          ]
        }
      ],
      "feel_good": {
        "extra": "has_logged=true&query_flag1=0&query_flag2=0&query_usability=0&user_id=7575732145533125654",
        "token": "[REDACTED]",
        "token_type": "Bearer"
      },
      "hide_results": false,
      "hit_dolphin": false
    },
    "has_more": 1,
    "type": 1
  },
  "docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_user_search_result_api_v1_tiktok_app_v3_fetch_user_search_result_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "dc408418-fc2d-4d2e-9100-83b714569f3e"
}

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