Recipes
Ten working recipes that solve real cross-platform tasks — brand monitoring, sentiment analysis, competitor tracking, TikTok analytics, transcripts, ad aggregation, engagement scoring, music trends, and hybrid search.
Recipes
Each recipe solves one specific task you'd arrive with. Code is TypeScript, runs on Node 22+, uses native fetch, and assumes SOCIALCRAWL_KEY is in your environment. Every snippet is copy-paste runnable — handles, queries, and URLs are real.
Cost callouts appear in every recipe so you can budget before you build. New to the API? Start with the Quickstart — it takes 5 minutes.
| Recipe | What you'll build | Cost per run |
|---|---|---|
| Brand mention monitoring | Daily brand-mention sweep across 12 platforms | 20 credits |
| Social listening pulse-check | Streaming search over 12 platforms with comments enriched | 20 credits |
| Sentiment analysis | Social sentiment pipeline feeding an LLM | 23 credits |
| Competitor tracking | Cross-platform competitor account snapshots | 8 credits per competitor |
| TikTok analytics dashboard | Profile, video, and comment metrics with engagement rates | 3 credits per refresh |
| Video transcription | One transcription function, seven platforms | 10 credits per video |
| Ad library aggregation | Parallel fan-out across four ad networks | 20 credits |
| Creator engagement scoring | Apples-to-apples engagement-rate ranking | 3 credits per creator |
| Music trend detection | Cross-platform music heat score | 3 credits per song |
| Hybrid search-then-enrich | Universal search plus per-platform transcripts | 120 credits |
Which recipe should I start with?
If you're evaluating SocialCrawl, start with Brand mention monitoring or the Social listening pulse-check — both are a single call to GET /v1/search/everywhere, cost a flat 20 credits, and show the universal search endpoint that differentiates SocialCrawl from web-search APIs. If you already know which platform you need, TikTok analytics dashboard is the cheapest end-to-end example at 3 credits.
See also
- Quickstart — get an API key and make your first request
- Endpoint pricing — every endpoint and its credit cost
- Computed fields — formulas for
engagement_rate,language,content_category,estimated_reach - Pagination — when you need more than the first page from any list endpoint
- Universal social search — full reference for the endpoint that powers the search recipes
Versioning & Deprecation
What /v1 promises. How SocialCrawl ships additive changes safely, what counts as a breaking change, the 90-day deprecation window, and the CI gate that enforces it on every pull request
Brand mention monitoring
Run a daily brand-mention sweep across 12 social platforms with one API call, dedupe against yesterday's results, and alert on what's new — 20 credits per sweep.