Endpoint pricing
Every active SocialCrawl endpoint and what each call costs in credits — generated from the registry, always current.
Endpoint pricing
Every SocialCrawl request is billed in credits. Most endpoints cost 1 credit per successful call; a handful are tiered higher because their upstream is slower, returns more data, or runs additional compute. A small set of bundle endpoints use a flat override that bypasses the tier ladder entirely.
This page lists every active endpoint and its exact credit cost. It's generated from the same registry the router uses to charge your balance — when an endpoint moves tiers or a new override ships, this page updates on the next pnpm generate:docs run.
For how charging, refunds, and cache hits work — see Credits.
The tier ladder
| Tier | Credits | Endpoints | Typical use |
|---|---|---|---|
| Standard | 1 | 115 | Profiles, posts, comments, basic search |
| Advanced | 5 | 17 | Trending feeds, ad libraries, audience analytics |
| Premium | 10 | 7 | Video transcripts, age/gender detection |
| Custom | varies | 1 | Bundle / fan-out endpoints (see below) |
Totals: 140 active endpoints across 28 platforms. Soft-disabled endpoints aren't shown — the router returns 503 for those without charging credits.
Custom-priced endpoints
A small number of endpoints don't fit the 1/5/10 tier ladder. They charge a flat fee that reflects how many upstream calls or how much compute a single request kicks off.
| Endpoint | Cost | What you get |
|---|---|---|
GET /v1/search/everywhere | 20 credits | Universal social search across 12 platforms |
Every endpoint
Sorted alphabetically by platform, highest-cost endpoints first within each.
Amazon
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Amazon shop page | GET /v1/amazon/shop | 1 | standard |
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Facebook video transcript | GET /v1/facebook/post/transcript | 10 | premium |
| Get Facebook Ad Library ad details | GET /v1/facebook/adlibrary/ad | 5 | advanced |
| List Facebook Ad Library company ads | GET /v1/facebook/adlibrary/company/ads | 5 | advanced |
| Search Facebook Ad Library | GET /v1/facebook/adlibrary/search/ads | 5 | advanced |
| Search Facebook Ad Library companies | GET /v1/facebook/adlibrary/search/companies | 5 | advanced |
| List Facebook group posts | GET /v1/facebook/group/posts | 1 | standard |
| Get Facebook post details | GET /v1/facebook/post | 1 | standard |
| List Facebook post comments | GET /v1/facebook/post/comments | 1 | standard |
| Get Facebook page profile | GET /v1/facebook/profile | 1 | standard |
| List Facebook profile photos | GET /v1/facebook/profile/photos | 1 | standard |
| List Facebook page posts | GET /v1/facebook/profile/posts | 1 | standard |
| List Facebook profile reels | GET /v1/facebook/profile/reels | 1 | standard |
GitHub
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| User contribution velocity dossier | GET /v1/github/user/profile-velocity | 10 | premium |
| Full project dossier for a repository | GET /v1/github/repo/dossier | 5 | advanced |
| Top feature request and top complaint for a repository | GET /v1/github/repo/top-issues | 5 | advanced |
| Get a single issue or pull request | GET /v1/github/issue | 1 | standard |
| Get comments on an issue or pull request | GET /v1/github/issue/comments | 1 | standard |
| Get a GitHub user profile | GET /v1/github/profile | 1 | standard |
| List a GitHub user's repositories | GET /v1/github/profile/repos | 1 | standard |
| Get a GitHub repository | GET /v1/github/repo | 1 | standard |
| List a repository's issues (and PRs) | GET /v1/github/repo/issues | 1 | standard |
| Get a repository's README | GET /v1/github/repo/readme | 1 | standard |
| List a repository's releases | GET /v1/github/repo/releases | 1 | standard |
| Search GitHub issues and pull requests | GET /v1/github/search | 1 | standard |
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Google ad details | GET /v1/google/ad | 5 | advanced |
| Search Google Ad Library advertisers | GET /v1/google/adlibrary/advertisers/search | 5 | advanced |
| List Google ads by company | GET /v1/google/company/ads | 5 | advanced |
| Google web search | GET /v1/google/search | 1 | standard |
Hacker News
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get a Hacker News user profile | GET /v1/hackernews/profile | 1 | standard |
| Search Hacker News | GET /v1/hackernews/search | 1 | standard |
| Get a Hacker News story | GET /v1/hackernews/story | 1 | standard |
| Get comments on a Hacker News story | GET /v1/hackernews/story/comments | 1 | standard |
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Instagram media transcript | GET /v1/instagram/media/transcript | 10 | premium |
| Get Instagram basic profile | GET /v1/instagram/basic-profile | 1 | standard |
| Get Instagram highlight detail | GET /v1/instagram/highlight/detail | 1 | standard |
| List Instagram story highlights | GET /v1/instagram/highlights | 1 | standard |
| Get Instagram post details | GET /v1/instagram/post | 1 | standard |
| List Instagram post comments | GET /v1/instagram/post/comments | 1 | standard |
| Get Instagram user profile | GET /v1/instagram/profile | 1 | standard |
| List Instagram user posts | GET /v1/instagram/profile/posts | 1 | standard |
| List Instagram user reels | GET /v1/instagram/profile/reels | 1 | standard |
| Search Instagram reels | GET /v1/instagram/search/reels | 1 | standard |
| List Instagram reels using a song | GET /v1/instagram/song/reels | 1 | standard |
| Get Instagram user embed HTML | GET /v1/instagram/user/embed | 1 | standard |
Kick
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Kick clip details | GET /v1/kick/clip | 1 | standard |
Komi
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Komi page | GET /v1/komi/page | 1 | standard |
LinkBio
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Linkbio page | GET /v1/linkbio/page | 1 | standard |
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get LinkedIn ad details | GET /v1/linkedin/ad | 5 | advanced |
| Search LinkedIn ads | GET /v1/linkedin/ads/search | 5 | advanced |
| Get LinkedIn company page | GET /v1/linkedin/company | 1 | standard |
| List LinkedIn company posts | GET /v1/linkedin/company/posts | 1 | standard |
| Get LinkedIn post details | GET /v1/linkedin/post | 1 | standard |
| Get LinkedIn user profile | GET /v1/linkedin/profile | 1 | standard |
LinkMe
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Linkme profile | GET /v1/linkme/page | 1 | standard |
Linktree
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Linktree page | GET /v1/linktree/page | 1 | standard |
Naver
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Search Naver Blog | GET /v1/naver/blog/search | 1 | standard |
| Search Naver Book | GET /v1/naver/book/search | 1 | standard |
| Search Naver Cafe articles | GET /v1/naver/cafearticle/search | 1 | standard |
| Search Naver Academic Documents (전문자료) | GET /v1/naver/doc/search | 1 | standard |
| Search Naver Encyclopedia | GET /v1/naver/encyc/search | 1 | standard |
| Search Naver Image | GET /v1/naver/image/search | 1 | standard |
| Search Naver KnowledgeiN (지식iN) | GET /v1/naver/kin/search | 1 | standard |
| Search Naver Local (장소 검색) | GET /v1/naver/local/search | 1 | standard |
| Search Naver News | GET /v1/naver/news/search | 1 | standard |
| Search Naver Shopping | GET /v1/naver/shop/search | 1 | standard |
| Search Naver Web (웹문서) | GET /v1/naver/webkr/search | 1 | standard |
Perplexity
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Web research via Perplexity Sonar | GET /v1/perplexity/research | 1 | standard |
Pillar
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Pillar page | GET /v1/pillar/page | 1 | standard |
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Pinterest board | GET /v1/pinterest/board | 1 | standard |
| Get Pinterest pin details | GET /v1/pinterest/pin | 1 | standard |
| Search Pinterest pins | GET /v1/pinterest/search | 1 | standard |
| List Pinterest user boards | GET /v1/pinterest/user/boards | 1 | standard |
Polymarket
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Polymarket prediction markets — multi-query research | GET /v1/polymarket/research | 5 | advanced |
| Search Polymarket prediction markets | GET /v1/polymarket/search | 1 | standard |
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Reddit ad details | GET /v1/reddit/ad | 5 | advanced |
| Search Reddit ads | GET /v1/reddit/ads/search | 5 | advanced |
| List Reddit post comments | GET /v1/reddit/post/comments | 1 | standard |
| Search Reddit posts | GET /v1/reddit/search | 1 | standard |
| List Reddit subreddit posts | GET /v1/reddit/subreddit | 1 | standard |
| Get Reddit subreddit details | GET /v1/reddit/subreddit/details | 1 | standard |
| Search within a subreddit | GET /v1/reddit/subreddit/search | 1 | standard |
Snapchat
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Snapchat user profile | GET /v1/snapchat/profile | 1 | standard |
Tavily
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Crawl a website with LLM-driven path selection | GET /v1/tavily/crawl | 1 | standard |
| Extract clean content from one or more URLs | GET /v1/tavily/extract | 1 | standard |
| Map a website's sitegraph | GET /v1/tavily/map | 1 | standard |
| Tavily web search with optional LLM-generated answer | GET /v1/tavily/search | 1 | standard |
Threads
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Threads post details | GET /v1/threads/post | 1 | standard |
| Get Threads user profile | GET /v1/threads/profile | 1 | standard |
| Search Threads posts | GET /v1/threads/search | 1 | standard |
| Search Threads users | GET /v1/threads/search/users | 1 | standard |
| List Threads user posts | GET /v1/threads/user/posts | 1 | standard |
TikTok
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get TikTok video transcript | GET /v1/tiktok/post/transcript | 10 | premium |
| Get TikTok trending feed | GET /v1/tiktok/trending | 5 | advanced |
| Get TikTok user audience demographics | GET /v1/tiktok/user/audience | 5 | advanced |
| Get TikTok post details | GET /v1/tiktok/post | 1 | standard |
| List TikTok post comments | GET /v1/tiktok/post/comments | 1 | standard |
| Get TikTok user profile | GET /v1/tiktok/profile | 1 | standard |
| List TikTok user videos | GET /v1/tiktok/profile/videos | 1 | standard |
| Search TikTok videos by keyword | GET /v1/tiktok/search | 1 | standard |
| Search TikTok by hashtag | GET /v1/tiktok/search/hashtag | 1 | standard |
| TikTok top search results | GET /v1/tiktok/search/top | 1 | standard |
| Search TikTok users | GET /v1/tiktok/search/users | 1 | standard |
| Get TikTok Shop product details | GET /v1/tiktok/shop/product | 1 | standard |
| List TikTok Shop product reviews | GET /v1/tiktok/shop/product/reviews | 1 | standard |
| List TikTok Shop products | GET /v1/tiktok/shop/products | 1 | standard |
| Search TikTok Shop products | GET /v1/tiktok/shop/search | 1 | standard |
| Get TikTok song details | GET /v1/tiktok/song | 1 | standard |
| List TikTok videos using a song | GET /v1/tiktok/song/videos | 1 | standard |
| List TikTok user followers | GET /v1/tiktok/user/followers | 1 | standard |
| List TikTok user following | GET /v1/tiktok/user/following | 1 | standard |
| Get TikTok user live stream | GET /v1/tiktok/user/live | 1 | standard |
| List TikTok user showcase products | GET /v1/tiktok/user/showcase | 1 | standard |
| List TikTok comment replies | GET /v1/tiktok/video/comment/replies | 1 | standard |
Truth Social
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Truth Social post details | GET /v1/truthsocial/post | 1 | standard |
| Get Truth Social user profile | GET /v1/truthsocial/profile | 1 | standard |
| List Truth Social user posts | GET /v1/truthsocial/user/posts | 1 | standard |
Twitch
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Twitch clip details | GET /v1/twitch/clip | 1 | standard |
| Get Twitch streamer profile | GET /v1/twitch/profile | 1 | standard |
Twitter/X
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get Twitter video transcript | GET /v1/twitter/tweet/transcript | 10 | premium |
| AI-powered X (Twitter) search via xAI Grok | GET /v1/twitter/ai-search | 1 | standard |
| Get Twitter community details | GET /v1/twitter/community | 1 | standard |
| List Twitter community tweets | GET /v1/twitter/community/tweets | 1 | standard |
| Get Twitter user profile | GET /v1/twitter/profile | 1 | standard |
| Get Twitter tweet details | GET /v1/twitter/tweet | 1 | standard |
| List Twitter user tweets | GET /v1/twitter/user/tweets | 1 | standard |
Universal Search
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Universal social search across 12 platforms | GET /v1/search/everywhere | 20 | custom |
Utility
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Detect age and gender | GET /v1/utility/age-gender | 10 | premium |
YouTube
| Endpoint | Path | Credits | Tier |
|---|---|---|---|
| Get YouTube video transcript | GET /v1/youtube/video/transcript | 10 | premium |
| Get trending YouTube shorts | GET /v1/youtube/shorts/trending | 5 | advanced |
| Get YouTube channel info | GET /v1/youtube/channel | 1 | standard |
| List YouTube channel shorts | GET /v1/youtube/channel/shorts | 1 | standard |
| List YouTube channel videos | GET /v1/youtube/channel/videos | 1 | standard |
| Get YouTube community post | GET /v1/youtube/community-post | 1 | standard |
| Get YouTube playlist | GET /v1/youtube/playlist | 1 | standard |
| Search YouTube videos | GET /v1/youtube/search | 1 | standard |
| Search YouTube by hashtag | GET /v1/youtube/search/hashtag | 1 | standard |
| Get YouTube video details | GET /v1/youtube/video | 1 | standard |
| List YouTube comment replies | GET /v1/youtube/video/comment/replies | 1 | standard |
| List YouTube video comments | GET /v1/youtube/video/comments | 1 | standard |
How costs are charged
- Successful calls deduct the credits listed above the moment the response is dispatched.
- Cache hits (
"cached": true) deduct 0 credits — see Credits → Are cache hits free?. - Upstream errors, 5xx, and empty-body 404s automatically refund the deduction. Full matrix in Credits → When are credits refunded?.
- Idempotent retries with the same
Idempotency-Keyheader charge once, no matter how many times you replay.
Your remaining balance comes back in every response as credits_remaining and as the X-Credits-Remaining header. Need a programmatic check without a charge? Call GET /v1/credits/balance — that one is always 0 credits.
