# TikTok Similar API (https://www.socialcrawl.dev/platforms/tiktok/similar)

> Returns TikTok accounts similar to a given creator: the related accounts TikTok itself suggests for that profile, usually about 30. Some creators get only a few, and for some TikTok suggests none. Each account includes the username, display name, avatar, profile URL, bio, verification status, whether it is private, and its follower, following, video and like counts, so no second lookup is needed to size or qualify a lookalike. Pass `handle`. The list is specific to the seed: a chef returns other chefs and food creators, a dancer returns other dancers. To go wider, call it again with any returned username as the next `handle`. When TikTok has no list for the creator, the list is built from TikTok's lists that include the creator: the accounts whose list names the creator, then the other accounts on those lists, ranked by how many of those lists they appear on. Those rows carry `author.ext.similar_source` set to `tiktok_graph` and `author.ext.similar_via`, the account whose list named the creator. Any remaining places are filled from the accounts Instagram suggests for the same creator, matched to their TikTok accounts and kept only when the TikTok account is verified, has at least 10,000 followers, or has at least 1,000 followers and a display name that shares a word with the Instagram account; the creator's Instagram account is the one linked or named in the TikTok bio when there is one. Those rows carry `author.ext.similar_source` set to `instagram` and `author.ext.instagram_username`. TikTok's own rows carry neither. Cost: 5 credits a call. A creator with no suggestions returns an empty list and is refunded, and a handle TikTok does not know is a 404 at no cost. A repeat within the cache window is 0 credits. The list is a single fixed window: it is not paginated and returns no cursor. author.location is not published on this surface and is null on every row; `GET /v1/tiktok/profile` returns the region for any single account.

TL;DR: `GET /v1/tiktok/similar` costs 5 credits a call. An empty list is refunded, an unknown handle is a free 404, and the list is cached for 15 minutes, so a repeat within that window costs 0. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | TikTok username of the seed creator, without the @ symbol. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktok/similar" \
  --data-urlencode "handle=gordonramsayofficial" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the TikTok Similar API return?

Returns about 30 creators similar to a TikTok account, from TikTok's suggestions or, when those are unavailable, Instagram's matched to TikTok, each with bio and counts. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the TikTok Similar endpoint?

Use it to find lookalike creators for one you already know; it returns a single fixed list, so call it again on a result to go wider.

### How much does the TikTok Similar API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the TikTok Similar API need?

The one required parameter is handle (tikTok username of the seed creator, without the @ symbol).

### How do I call the TikTok Similar API?

Send a GET request to https://www.socialcrawl.dev/v1/tiktok/similar?handle=gordonramsayofficial with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl TikTok Similar API return?
- How do I get TikTok Similar data with the SocialCrawl API?