# TikTok User Search

> TikTok User Search is a paid API for AI agents from x402.orthogonal.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Search for TikTok users by username query, with paginated results and cost-efficient continuation via parentRequestId.

## Facts

- Endpoint: GET https://x402.orthogonal.com/scrapecreators/v1/tiktok/search/users
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-user-search-55462c8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k_m9J8zA6rO8JLINwWhYR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tiktok-user-search-55462c8b
```

Example prompt: Search TikTok for users with the username 'dancewithme' and show me the first page of matching profiles.

## When to prefer this

Use this endpoint when you need to search for TikTok users by username or handle and want paginated results with cost-efficient continuation. It's the right choice for influencer discovery, creator research, and account lookup workflows on TikTok specifically. Prefer this over generic web search when you need structured TikTok user profile data rather than raw HTML.

## Known failure modes

- Empty results if no TikTok users match the query
- Invalid or expired cursor returns an error or empty page
- Missing required query parameter returns a 400-level error
- Rate limiting or TikTok-side blocking may cause failures
- Changing filters mid-pagination starts a new billable request instead of continuing

## How this service works

Search Users Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

## Output

Returns a list of TikTok user profiles matching the search query, including usernames, profile details, and a pagination cursor for fetching subsequent pages. If trim=true, returns a slimmed-down version of the response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "trim": {
       "type": "string",
       "description": "Set to true for a trimmed response"
      },
      "query": {
       "type": "string",
       "description": "Username to search for"
      },
      "cursor": {
       "type": "string",
       "description": "Cursor to get more results For later cursor pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-user-search-55462c8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.orthogonal.com](https://www.zero.xyz/host/x402.orthogonal.com/llms.txt)