# Find creators (/docs/engines/find-creators) Find the creators who post about your topic, measured from their recent posts and ranked with reasons, priced free first Creator search finds the people who post about your topic. It reads each creator's recent posts, measures them and ranks the list with the reasons. You set the size you want, such as a minimum number of followers. A dry run shows the price for 0 credits and starts nothing. ## Price it for free This search asks for 5 creators who post about home espresso on TikTok and Instagram and have at least 10,000 followers. `max_credits` is the most the run may spend. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/prism/creators?keywords=home+espresso&platforms=tiktok,instagram&min_followers=10000&limit=5&max_credits=100&deadline_s=60&dry_run=true" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "estimate": { "total": { "min": 15, "expected": 42, "max": 2272 }, "per_delivered": { "min": 3, "expected": 8.4, "max": 454.4 }, "answers_in_call": true }, "next_step": "Send the same request without dry_run to run it; it answers in this call and is expected to cost about 42 credits (about 8.4 a creator, at most 2272 in all, never past max_credits=100)." }, "credits_used": 0 } ``` `expected` is the likely price and `max` is the worst case. The run never spends more than `max_credits`. A new account's free credits cover this search. ## Run it Send the same request without `dry_run`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/prism/creators?keywords=home+espresso&platforms=tiktok,instagram&min_followers=10000&limit=5&max_credits=100&deadline_s=60" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (one creator, trimmed)" { "success": true, "data": { "items": [ { "account": { "key": "tiktok:alexhomebarista", "display_name": "Alex Home Barista", "followers": 238562, "url": "https://www.tiktok.com/@alexhomebarista", "metrics": { "median_views": 17212, "engagement_rate": 0.073926, "posts_used": 12 } }, "judgments": { "fit": { "p": 0.98 } }, "score": { "value": 0.74 } } ], "run": { "status": "completed", "credits": { "spent": 32 } } } } ``` In that run, 5 creators came back for 32 credits. `median_views` is the views of a typical recent post. `fit` is how well the creator matches your topic, from 0 to 1. `score` combines fit, engagement, posting activity and reach. ## What does it cost? You pay for the searches, the profile lookups and the scoring the run does. The dry run shows each part in `estimate`. A search that finds nothing, fails or comes from cache costs 0. A request whose expected cost is above `max_credits` is refused free, so a run cannot spend past your cap. ## How do you get thousands of creators? A larger search takes longer than one call can wait. It answers `202` with a run, and you follow `data.next.status_url` until the run is `completed`. The creators then download as one JSON object per line. Narrow the list with `min_followers`, `max_followers` and a market, and price each step with `dry_run` first. ## Next steps - [Creators quickstart](/docs/prism/creators-quickstart.md): From no key to a ranked list, then a thousand creators, in Python and TypeScript. - [Creator search reference](/docs/prism/creators.md): Every filter, field and price of creator search. - [Discover](/docs/engines/discover.md): Search posts instead of people.