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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
name | string | No | Query 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. | — |
page | integer | No | Pagination, up to 100 creators per page, default 1. Example: 1. | 1 |
site | enum (Unknow | US | MY) | No | TikTok site. | Unknow |
query_type | integer | No | Query 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.
/agent-api/v1/tool/executeX-Api-Key
