SocialCrawl

Influencer marketing

Find creators in a market, check their numbers and follow their new posts.

Influencer work on SocialCrawl starts with one creator search. You name a niche, a market and a size, and the run returns creators who fit, each with their numbers. Then you follow the shortlist and read only their new posts.

Start with a template

Run your first request

This request looks for creators about sourdough baking on TikTok and Instagram in the United Kingdom. dry_run=true makes it free: it returns the plan of searches and the estimate, and starts nothing.

cURL
curl "https://www.socialcrawl.dev/v1/prism/creators?keywords=sourdough,bread%20baking&platforms=tiktok,instagram&country=GB&min_followers=10000&limit=5&max_credits=200&dry_run=true" \
  -H "x-api-key: sc_your_key_here"
Python
import json
import urllib.parse
import urllib.request

params = urllib.parse.urlencode({
    "keywords": "sourdough,bread baking",
    "platforms": "tiktok,instagram",
    "country": "GB",
    "min_followers": 10000,
    "limit": 5,
    "max_credits": 200,
    "dry_run": "true",
})
url = "https://www.socialcrawl.dev/v1/prism/creators"
req = urllib.request.Request(
    url + "?" + params,
    headers={"x-api-key": "sc_your_key_here"},
)
with urllib.request.urlopen(req) as res:
    data = json.load(res)["data"]
print(data["estimate"]["formula"])
print(data["next_step"])
TypeScript
const url = new URL("https://www.socialcrawl.dev/v1/prism/creators");
url.searchParams.set("keywords", "sourdough,bread baking");
url.searchParams.set("platforms", "tiktok,instagram");
url.searchParams.set("country", "GB");
url.searchParams.set("min_followers", "10000");
url.searchParams.set("limit", "5");
url.searchParams.set("max_credits", "200");
url.searchParams.set("dry_run", "true");
const res = await fetch(url, { headers: { "x-api-key": "sc_your_key_here" } });
const { data } = await res.json();
console.log(data.estimate.formula);
console.log(data.next_step);

The answer prices the run, and next_step names the lowest max_credits the real run accepts. Send the same request without dry_run to start it. Endpoint pricing lists every other call.

country keeps creators whose profile or posts place them in that market. In some markets the run also plans searches in the local language, and only on the platforms where that was measured to work. data.market and _warnings say which platforms it did this on, so read them before you compare platforms.

How it works

  1. Price the search with dry_run=true and read the estimate.
  2. Run it with max_credits as a cap, then read the creators and their numbers.
  3. Follow the shortlist with the follow creators cookbook and read only their new posts.

Why teams choose SocialCrawl

One search covers several platforms. The creator search looks across TikTok, Instagram and YouTube in one request, and more when you name them.

You know the cost before the run. A dry run is free, and max_credits stops the run at your cap, as the request fields explain.

Every creator comes back in one row shape. Followers, typical views, engagement rate and country sit in the same fields whichever platform found the creator.

Questions

How do I find creators in one country above a follower floor?

Send country with a two-letter code and min_followers with the floor, as in the request above. Add unknown_country=keep to also see creators whose country is not stated. Creators in one country explains how the market is applied on each platform.

How do I follow creators and see only their new posts?

Save the creators you keep, then walk their own feeds on a schedule from the last date you read. The follow creators cookbook does this once a day and refreshes the numbers on the posts you store.