# TikTok User Profile Lookup

> TikTok User Profile Lookup is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Look up a single TikTok user's profile by username, numeric user ID, or profile URL.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/tiktok/user?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-user-profile-lookup-20e9b05f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UhXobXPkmxh_O9XJdLYVb

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-profile-lookup-20e9b05f
```

Example prompt: Can you pull up the TikTok profile for @charlidamelio — I want to see their follower count, bio, and account details?

## When to prefer this

Use this endpoint when you need detailed profile data for a specific known TikTok user (by username, user ID, or URL) rather than discovering users via search. Prefer this over a search endpoint when you already know the exact identifier. It's ideal for enriching influencer databases, resolving numeric IDs from handles, or verifying account existence and follower stats.

## Known failure modes

- Username not found — returns 404 or empty result if the account doesn't exist or has been deleted
- Invalid input — error if more than one of username/user_id/url is provided, or none are provided
- Malformed URL — error if url parameter does not contain the tiktok.com/@username segment
- Private or banned account — may return limited or no profile data
- Rate limiting — too many requests may result in 429 responses
- User ID all zeros — rejected per schema validation

## How this service works

Look up a single TikTok user by username, numeric user ID, or profile URL.

## Output

Returns detailed TikTok user profile data including the user's display name, username, numeric user ID, biography, avatar URL, follower count, following count, total likes, video count, and account verification status.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Must include the tiktok.com/@username segment. Provide exactly one of username, user_id, or url."
      },
      "user_id": {
       "type": "string",
       "maxLength": 20,
       "description": "Numeric TikTok user ID, as returned by Search Users. Digits only, max 20 characters, and not all zeros. Provide exactly one of username, user_id, or url."
      },
      "username": {
       "type": "string",
       "maxLength": 100,
       "description": "TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-user-profile-lookup-20e9b05f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)