## search/creators

`GET /v1/search/creators`

Cross-platform creator discovery over TikTok, Instagram and Threads: unified creator cards with reach, verification and per-card evidence (Threads creators are derived from matching posts and cite them). Every leg is metered, so the flagship fair-use ceiling applies; no creators found charges 0 and failed legs prorate.

*Creator search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Who to look for — a niche, a name, a topic. — e.g. `barefoot running` |
| `sources` | no | Comma list restricting the fan-out: tiktok, instagram, threads (default all three). — e.g. `tiktok,instagram` |
| `estimate` | no | true returns the plan and maximum cost without running anything. Free. — e.g. `true` |
| `stream` | no | 1 answers text/event-stream: plan, source-started, source-completed, cost and enrichment progress events as legs actually run, then one final result event carrying the exact envelope a plain call returns — same billing, same receipts. — e.g. `1` |
| `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. — e.g. `1` |

**Cost:** 10 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/search/creators?query=barefoot%20running" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [],
  "count": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/search/creators#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/search/creators.json)