## tiktok/similar-accounts

`GET /v1/tiktok/similar-accounts`

Lookalike TikTok creators for any handle: up to 30 Instagram-suggested accounts for the same creator are checked on TikTok, and each same-handle account that is verified or has at least 10,000 followers is returned with display name, avatar, bio, verification, privacy and follower, following, video and like counts. Rows carry similar_source and instagram_handle. Five credits; an empty list or an unknown handle is free, and a repeat within 15 minutes is served from cache.

*TikTok similar accounts*

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | TikTok username of the creator to find lookalikes for, with or without @. An optional leading @ is accepted and removed before lookup. — e.g. `tillyramsay` |
| `instagram_handle` | no | Optional Instagram username of the same creator. Without it, the creator's Instagram account is found by an exact handle or exact name match, never a guess. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/tiktok/similar-accounts?handle=tillyramsay" \
  -H "x-api-key: mn_your_key_here"
```