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 | 60 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/search/creators | 10 credits |
| Vet a creator | GET /v1/prism/creator-vet | 50 credits |
| Search a topic on several platforms | GET /v1/search/multi | 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 |
Watch a brand
Find recent posts about a brand across the social platforms and 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.
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 every comment on a post, replies included, and keep the ones that show buying intent.
Price per run: 60 credits.
GET /v1/prism/comments (60 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 and pay only for the pages with posts you do not have yet.
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 who post about a topic, filtered by platform and audience size.
Price per run: 10 credits.
GET /v1/search/creators (10 credits). Endpoint page
curl -H "x-api-key: YOUR_API_KEY" \ "https://www.socialcrawl.dev/v1/search/creators?query=skincare+routine&sources=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: 3 credits.
GET /v1/search/multi (3 credits). Endpoint page
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"