Start from a job
The jobs customers come to SocialCrawl for, each with the calls that do it, a cURL to copy and the price of one run
Pick the job you need done and copy its call. Each job below lists the calls that do it, a cURL you can paste with your key, and the price of one run in credits.
For a job in your own words, send it to GET /v1/utility/plan?query=. It returns the calls in order, with the values your words filled in and the price of each, and says so instead of guessing when it is not confident. The plan costs 0 credits and runs nothing. See Plan the calls for a job.
curl -G "https://www.socialcrawl.dev/v1/utility/plan" \
--data-urlencode "query=Combine @nike's TikTok profile with their recent videos and the comments on them" \
-H "x-api-key: YOUR_API_KEY"Prices are for one run of the example as shown. Some calls are metered and charge within a range that depends on how much work the call does; Endpoint pricing lists every range.
| Job | First call | Price per run |
|---|---|---|
| Watch a brand | GET /v1/prism/brand-mentions | 50 credits |
| What people say under a post | GET /v1/tiktok/post/comments | 1 credit |
| Mine comments for buyers | GET /v1/prism/comments | 2 to 120 credits |
| Profile, posts and comments for one creator | GET /v1/tiktok/profile | 3 credits |
| One creator on every platform | GET /v1/prism/creator-card | 5 credits |
| Track a creator daily | GET /v1/instagram/profile/posts | 1 credit |
| Find creators in a niche | GET /v1/prism/creators | 0 to 200 credits |
| Vet a creator | GET /v1/prism/creator-vet | 50 credits |
| Search a topic on several platforms | GET /v1/search/multi | 0 to 3 credits |
| Find posts from people ready to buy | GET /v1/reddit/search | 1 credit |
| Transcribe a video | GET /v1/youtube/video/transcript | 3 credits |
| See a competitor's ads | GET /v1/facebook/adlibrary/search/ads | 5 credits |
| What buyers say about a product | GET /v1/amazon/reviews | 5 credits |
| Monthly brand reaction | GET /v1/prism/discover | 0 to 150 credits |
| Find the accounts behind a topic | GET /v1/prism/discover | 0 to 400 credits |
Watch a brand
Find recent mentions of a brand on news sites, blogs and forums across the web, with a summary of what they say.
Price per run: 50 credits.
GET /v1/prism/brand-mentions (50 credits). Endpoint page
date_from is the first day of the window, as YYYY-MM-DD. To watch a brand across social platforms instead, with every post inside your dates, judged against your question and de-duplicated, send brands and period to prism/discover, and add a schedule to a POST to repeat it on its own (guide: /docs/prism/discover).
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/brand-mentions?keyword=socialcrawl&date_from={start_date}&include=digest"What people say under a post
Read the comments on a post and see which are questions, complaints or buyers, without judging them yourself.
Price per run: 1 credit.
GET /v1/tiktok/post/comments (1 credit). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/tiktok/post/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566&label=question%2Ccomplaint%2Cpurchase_intent"Mine comments for buyers
Collect up to 1,000 comments on a post, with replies on the top 100, and keep the ones that show buying intent.
Price per run: 2 to 120 credits.
GET /v1/prism/comments (2 to 120 credits). Endpoint page
The first 100 comments of each call carry computed.labels.purchase_intent, judged by default at no extra credits.
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/comments?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566"Profile, posts and comments for one creator
Get a creator's profile, their recent posts, and the comments on one of those posts.
Price per run: 3 credits across 3 calls.
Step 1: GET /v1/tiktok/profile (1 credit). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/tiktok/profile?handle=charlidamelio"Step 2: GET /v1/tiktok/profile/videos (1 credit). Endpoint page
Each row's url feeds the comments call.
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/tiktok/profile/videos?handle=charlidamelio"Step 3: GET /v1/tiktok/post/comments (1 credit). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/tiktok/post/comments?url={url}"One creator on every platform
See the same creator's profiles on TikTok, Instagram, YouTube and X in one call.
Price per run: 5 credits.
GET /v1/prism/creator-card (5 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/creator-card?handle=mrbeast&platforms=tiktok%2Cinstagram%2Cyoutube%2Ctwitter"Track a creator daily
Poll a creator's new posts every day, stopping at the date of your last run so each poll pays only for the pages it reads.
Price per run: 1 credit.
GET /v1/instagram/profile/posts (1 credit). Endpoint page
since is the date of your previous run, as YYYY-MM-DD; leave it out on the first run.
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/instagram/profile/posts?handle=instagram&since={last_run_date}"Find creators in a niche
Find creators or influencers who post about a topic, filtered by platform, market and size, each measured from its recent posts and ranked with its reasons.
Price per run: 0 to 200 credits.
GET /v1/prism/creators (0 to 200 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/creators?keywords=skincare+routine&platforms=tiktok%2Cinstagram&min_followers=50000"Vet a creator
Check a creator before a partnership: audience, engagement and brand-safety signals in one call.
Price per run: 50 credits.
GET /v1/prism/creator-vet (50 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/creator-vet?handle=mkbhd&platform=youtube"Search a topic on several platforms
Run one search on TikTok, Instagram and YouTube at once and keep only the posts that are about it.
Price per run: 0 to 3 credits.
GET /v1/search/multi (0 to 3 credits). Endpoint page
search/multi is one quick pass. For a date window with every post judged against your question and de-duplicated across platforms, or a topic you want to watch on a recurring schedule, use prism/discover (guide: /docs/prism/discover).
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/search/multi?query=matcha+latte&platforms=tiktok%2Cinstagram%2Cyoutube&relevance=filter"Find posts from people ready to buy
Search discussions for a product category and mark the posts where someone is looking to buy.
Price per run: 1 credit.
GET /v1/reddit/search (1 credit). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/reddit/search?query=best+crm+for+startups&label=intent&relevance=filter"Transcribe a video
Get the full transcript of a video to search, summarise or quote it.
Price per run: 3 credits.
GET /v1/youtube/video/transcript (3 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ"See a competitor's ads
List the ads a company is running, from the public ad library.
Price per run: 5 credits.
GET /v1/facebook/adlibrary/search/ads (5 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/facebook/adlibrary/search/ads?query=artificial+intelligence"What buyers say about a product
Read a product's reviews with the issue each one raises and its sentiment already judged.
Price per run: 5 credits.
GET /v1/amazon/reviews (5 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/amazon/reviews?asin=B0BTYCRJSS&country=US&label=issue"Monthly brand reaction
See how people reacted to a brand and its competitors over last month, across the social platforms and the news, judged and de-duplicated in one run.
Price per run: 0 to 150 credits.
GET /v1/prism/discover (0 to 150 credits). Endpoint page
A 202 answer keeps running in the background: wait on data.next.status_url and read every row at data.next.results_url.
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/discover?brands=aruba%2Ccuracao%2Cbonaire&period=last_month&exclude_terms=networks&max_credits=150"Find the accounts behind a topic
Find the public accounts (sellers, creators, pages and channels) whose posts match a topic, each with its profile and the posts that matched.
Price per run: 0 to 400 credits.
GET /v1/prism/discover (0 to 400 credits). Endpoint page
Topic words go in keywords and the user's question in context; role=seller,reseller keeps only sellers.
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/prism/discover?keywords=replica+rolex+dubai%2Cfake+watches+uae&context=accounts+selling+counterfeit+luxury+watches+in+the+UAE&view=accounts&period=90d&max_credits=400"