SocialCrawl
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.

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"
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.

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"
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

On this page