Social listening API
Search posts for a keyword on several platforms and keep every hit as JSON.
100 free credits. No card needed.
The job, in one paragraph.
Your customers, or your client's, talk about the category on five platforms and your tool covers none of them natively. Run the same queries against each platform's search, normalize the hits into one table, and let a monitor push only what is new.
Who builds it: Product teams that put market signal inside their own tool, and agencies that listen for clients across TikTok, YouTube, Instagram, Threads and X.
What you end up with.
One feed of posts across platforms. Every hit has the same author, text, stats and date fields, so a TikTok video, a Threads post and a tweet sit in one table and one dashboard.
| Platform | Author | Text | Likes | Posted |
|---|---|---|---|---|
| tiktok | @creator | Switched to a standing desk and my back thanks me | 18,400 | 2026-11-09 |
| threads | @studio.account | Anyone else struggling to find a quiet desk setup? | 212 | 2026-11-09 |
| @reviewer | Three weeks in, the standing desk was worth it | 96 | 2026-11-08 | |
| tiktok | @daily.setup | Cable management for a standing desk | 7,050 | 2026-11-07 |
Example rows. The columns are real fields of the response: platform, author.handle, text, stats.likes, published_at.
| Endpoint | Returns | Cost |
|---|---|---|
| GET /v1/tiktok/search/keyword | TikTok video search | 1 credit |
| GET /v1/youtube/search | YouTube search | 1 credit |
| GET /v1/instagram/search/reels | Instagram reel search | 1 credit |
| GET /v1/threads/search | Threads post search | 1 credit |
| GET /v1/twitter/search/posts | X post search | 1 credit |
| POST /v1/monitors | Create a monitor | Free |
Failed requests and cached repeats cost 0 credits. Send max_age_days to accept a recent cached copy. See credits and caching.
The recipe, ready to run.
Calls use api.socialscrape.dev and return the shapes in the reference.
import os import requests API = "https://api.socialscrape.dev" HEADERS = {"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]} def get(path, **params): res = requests.get(API + path, headers=HEADERS, params=params, timeout=60) res.raise_for_status() return res.json()["data"] # TikTok video search tiktok = get("/v1/tiktok/search/keyword", query="standing desk", sort="latest", date_posted="week") # YouTube search youtube = get("/v1/youtube/search", query="standing desk", type="video", upload_date="week") for post in tiktok["items"] + youtube["items"]: print(post["platform"], post["url"])
const API = "https://api.socialscrape.dev"; const headers = { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! }; async function get(path: string, params: Record<string, string | number | boolean>) { const query = new URLSearchParams(Object.entries(params).map(([k, v]) => [k, String(v)])); const res = await fetch(`${API}${path}?${query}`, { headers }); if (!res.ok) throw new Error(`${res.status} ${await res.text()}`); return (await res.json()).data; } // TikTok video search const tiktok = await get("/v1/tiktok/search/keyword", { query: "standing desk", sort: "latest", date_posted: "week" }); // YouTube search const youtube = await get("/v1/youtube/search", { query: "standing desk", type: "video", upload_date: "week" }); for (const post of [...tiktok.items, ...youtube.items]) console.log(post.platform, post.url);
Good to know. Each platform ranks its own search, so the same term gives different lists. Twitter/X search goes through a web search engine, so it is a sample of posts, not the full firehose.
What it costs a month.
Three sizes of the job, priced from the endpoints' own costs.
| Size | What it runs | Credits a month | Monthly plan | Or with packs |
|---|---|---|---|---|
| One topic | 5 search terms on TikTok, Threads and X, twice a day | 900 | Starter plan, $27 a month | Starter pack, $13, lasts about a month (about $12 a month) Cheaper |
| Listening product | About 1,300 searches a day: customers' queries spread over five platforms | 39,000 | Growth plan, $73 a month | Scale pack, $349, lasts about 6 months (about $59 a month) Cheaper |
| Agency | About 4,400 searches a day for 40 clients across five platforms | 132,000 | Scale plan, $209 a month | Scale pack, $349, lasts about 2 months (about $200 a month) Cheaper |
Each call is 1 credit, failed requests cost nothing, and pack credits never expire. Volumes above the largest plan (1M+ credits a month, custom) are priced on request. One page of results per search. The agency size covers 40 clients searched about four times a day.
Running it as a team.
- Key each query by platform plus post id. The same post matches several of your terms, and one row per id keeps your counts honest.
- Treat X as a sample: it is searched through a web search engine, so tell your users it surfaces notable posts, not every one.
- Run each platform's search separately and tag the row with the query that found it, so a customer can see which term earned a mention.
- Put the searches that matter on monitors and keep a daily sweep for the long tail, so urgent mentions reach your webhook within the hour.