- Use cases
- Influencer discovery API
Influencer discovery API
Search creators by keyword, then read their follower counts and linked profiles.
The job
Discovery is a funnel: search a niche, pull each creator's numbers, then find where else they publish. Three calls per creator.
Endpoints
Failed requests and cached repeats cost 0 credits. Send max_age_days to accept a recent cached copy. See credits and caching.
| Endpoint | Returns | Cost |
|---|---|---|
| TikTok user search | 1 credit | |
| TikTok profile | 1 credit | |
| Find a creator's other social profiles | 1 credit | |
| Instagram profile | 1 credit | |
| YouTube channel details | 1 credit |
Recipe
- Search users for a niche term.
- Read each profile for followers, bio and verification.
- Follow the links in their bio to their other platforms.
1import os2import requests34API = "https://api.socialscrape.dev"5HEADERS = {"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]}678def get(path, **params):9 res = requests.get(API + path, headers=HEADERS, params=params, timeout=60)10 res.raise_for_status()11 return res.json()["data"]1213# TikTok user search14found = get("/v1/tiktok/search/users", query="home barista")15# TikTok profile16profile = get("/v1/tiktok/profile", handle=found["items"][0]["handle"])17# Find a creator's other social profiles18linked = get("/v1/creators/social-profiles", handle=found["items"][0]["handle"], platform="tiktok")1920print(profile["handle"], profile["stats"]["followers"])21for p in linked["items"]:22 print(p["platform"], p["url"])1const API = "https://api.socialscrape.dev";2const headers = { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! };34async function get(path: string, params: Record<string, string | number | boolean>) {5 const query = new URLSearchParams(Object.entries(params).map(([k, v]) => [k, String(v)]));6 const res = await fetch(`${API}${path}?${query}`, { headers });7 if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);8 return (await res.json()).data;9}1011// TikTok user search12const found = await get("/v1/tiktok/search/users", { query: "home barista" });13// TikTok profile14const profile = await get("/v1/tiktok/profile", { handle: found.items[0].handle });15// Find a creator's other social profiles16const linked = await get("/v1/creators/social-profiles", { handle: found.items[0].handle, platform: "tiktok" });1718console.log(profile.handle, profile.stats.followers);19for (const p of linked.items) console.log(p.platform, p.url);Calls use api.socialscrape.dev and return the shapes in the reference.
Good to know
Numbers are the counts at the time of the call. Engagement per video comes from the creator's own posts, not from the profile.