# SocialFetch TikTok Profile Lookup

> SocialFetch TikTok Profile Lookup is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Retrieves public profile data for a TikTok account by its handle.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/tiktok/profiles/:handle
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/socialfetch-tiktok-profile-lookup-7a5c1147
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TtdW8OVBWesPm63gVUB6E

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 socialfetch-tiktok-profile-lookup-7a5c1147
```

Example prompt: Can you pull up the TikTok profile for @charlidamelio and show me their bio, follower count, and account details?

## When to prefer this

Use this endpoint when you need to look up a single TikTok creator or account's public profile metadata by their handle. Ideal for influencer research, audience analysis, or enriching datasets with TikTok profile attributes. Prefer this over manual scraping or browser automation when you need a clean, structured profile response via a simple API call.

## Known failure modes

- Handle not found — TikTok account does not exist or is private, returns 404 or empty result
- Invalid handle format — handle exceeds 128 characters or is empty, returns validation error
- TikTok rate limiting or blocking — upstream TikTok platform throttles the lookup
- Payment failure — x402 payment of $0.014 USDC not processed, request rejected
- Handle with special characters — may cause URL parsing issues if not properly encoded

## How this service works

Get a TikTok profile by handle.

## Output

Returns structured public profile data for the specified TikTok account, including fields such as display name, bio, follower/following counts, like counts, and other publicly available account metadata.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "maxLength": 128,
       "minLength": 1,
       "description": "TikTok handle to look up, with or without a leading @."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/socialfetch-tiktok-profile-lookup-7a5c1147/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)