- Use cases
- Lead generation from creator profiles
Lead generation from creator profiles
Read the links and contact details creators publish about themselves.
The job
Creators put their business email and links in their bio and link-in-bio page. Read what they published, and nothing else.
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 |
|---|---|---|
| Find a creator's emails | 1 credit | |
| Find a creator's other social profiles | 1 credit | |
| Linktree page | 1 credit | |
| TikTok profile | 1 credit | |
| Instagram profile | 1 credit |
Recipe
- Start from a handle you already have.
- Read the addresses and profiles they publish.
- Keep the source url next to every address.
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# Find a creator's emails14contacts = get("/v1/creators/emails", handle="khaby.lame", platform="tiktok")15# Find a creator's other social profiles16linked = get("/v1/creators/social-profiles", handle="khaby.lame", platform="tiktok")1718print(contacts)19for p in linked["items"]:20 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// Find a creator's emails12const contacts = await get("/v1/creators/emails", { handle: "khaby.lame", platform: "tiktok" });13// Find a creator's other social profiles14const linked = await get("/v1/creators/social-profiles", { handle: "khaby.lame", platform: "tiktok" });1516console.log(contacts);17for (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
Only addresses a creator published themselves are returned, each with where it was seen. Your outreach still has to follow the law where the person lives. See the acceptable use policy.
Related
Questions
Is there a policy on this?
Yes. Read the acceptable use policy before you send anything.