TikTok Author Search From Name

1 credits/call
ae_tiktok_author_search_from_name

Search TikTok affiliate creators by creator name, product, brand, or seller. Set query_type to 1 for a case-insensitive fuzzy creator-name search, 2 for a product ID or product-title keyword (Chinese supported), 3 for an exact full brand name (up to 10 brands separated by commas), or 4 for a seller's shop ID; put the corresponding value in name. Use site to select US, MY, or the schema's default value Unknow, and page to choose a result page (default 1). Specify query_type explicitly: its schema default is 0, whose behavior is not documented. The provider gives inconsistent per-page limits, so a fixed page size is not confirmed. Result fields are not defined by an output schema.

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

The query mode, site, and number of creators returned do not change the fixed charge per call. Including multiple brands in a brand search does not add a charge based on brand count. Fetching the next page requires another call and incurs another per-call charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
namestringNoQuery keyword; the content varies by QueryType: QueryType=1 (by creator name): creator name, case-insensitive, example: FashionLisa; QueryType=2 (by product): product ID or keyword contained in the product title (Chinese supported), queries creators promoting the product, example: 1729448464509734958; QueryType=3 (by brand): full brand name, exact match, multiple brands separated by commas, up to 10 brands, example: medicube; QueryType=4 (by seller): shop ID, queries creators partnering with this seller, example: 7495830785034323995. Example: 1.—
pageintegerNoPagination, up to 100 creators per page, default 1. Example: 1.1
siteenum (Unknow | US | MY)NoTikTok site.Unknow
query_typeintegerNoQuery mode: 1=by creator name (default), 2=by product, 3=by brand, 4=by seller. 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_author_search_from_name' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "name": "Konssy",
    "query_type": 3,
    "site": "US"
  }
}'
Response exampleresponse.json
JSON
"No data available."