# TrueScrape

> Social data infrastructure that tells you when things change

One unified schema across every platform, async jobs with no timeout ceiling, and webhooks that fire when a creator posts. You are never charged for failed requests, empty results, or cache hits.

Public, logged-out data only. No authenticated scraping, no cookies, no logged-in sessions.

## Billing guarantees

Each one is enforced by the API and covered by a test, not a marketing line.

- **You are never charged for a failed request.** Platform failures, timeouts, not-founds, schema drift, and our own internal errors all refund in full before the error reaches you.
- **You are never charged for an empty result.** A profile with no posts, a video with no captions, a search with no hits: you still get a 200, and creditsCharged reads 0.
- **Cache hits cost 0 credits.** Pass cache_max_age=7d to say how stale you will tolerate. A hit never invokes a scraper and never bills.
- **An invalid API key is an auth error, not a billing error.** A wrong key returns 401. A 402 always means the key is valid and the balance is not. The two are never confused.
- **Every endpoint's price is machine-readable.** x-credit-cost sits on every operation in openapi.json, so an agent can compute spend from the spec alone.
- **A balance can never go negative.** Charges are a conditional database update. Run a thousand concurrent requests against a balance of one and exactly one succeeds.
- **Per-tenant cache isolation is standard.** Not an enterprise upsell. Turn it on and your team reads and writes only its own scope, permanently.
- **Hard daily spend caps.** Set a ceiling in credits per UTC day. Requests past it fail with 429 before any charge is taken, not after.

## Pricing

- **Free** ($0, forever): 1,000 credits, once. Evaluating whether the data is good enough.
- **Credit packs** (From $25, one-time, no subscription): 20,000 credits and up. $1.25 per 1,000, down to $0.80 at volume. A product in production with real volume.
- **Enterprise** (Custom): Committed volume. Buying through a security review.

## Docs

- [Overview](https://truescrape.com/docs): Concepts, the unified schema, jobs and webhooks, errors and billing.
- [Quickstart](https://truescrape.com/docs/quickstart): A key and a first request, with the response shape explained.
- [API reference](https://truescrape.com/docs/api): Every endpoint with its parameters, credit cost and cache policy.
- [Playground](https://truescrape.com/docs/playground): Fire a real request from the browser and read the credit and cache headers that come back.
- [Free tools](https://truescrape.com/docs/tools): Every free tool, the endpoint it runs and its credit cost.
- [Unified schema](https://truescrape.com/docs/schema): The unified Creator, Post, Comment, Transcript and Ad objects every platform returns.
- [Agents & tools](https://truescrape.com/docs/agents): The MCP server, CLI and agent skill, and how to wire them up.
- [Jobs, batches & webhooks](https://truescrape.com/docs/jobs): Async jobs with no timeout ceiling, batches, and webhooks that fire when a creator posts.
- [Mention monitors](https://truescrape.com/docs/monitors): Watch a brand, a term or named accounts across platforms, on a schedule or only when asked, and read what is new in a feed or on a webhook.
- [Errors & billing](https://truescrape.com/docs/errors): Every error code, whether it is retryable, and why failed requests are never billed.

## Platform APIs

- [Amazon API](https://truescrape.com/amazon-api): What the Amazon endpoints return, with examples.
- [Apple Music API](https://truescrape.com/apple-music-api): What the Apple Music endpoints return, with examples.
- [Bilibili API](https://truescrape.com/bilibili-api): What the Bilibili endpoints return, with examples.
- [BitChute API](https://truescrape.com/bitchute-api): What the BitChute endpoints return, with examples.
- [Bluesky API](https://truescrape.com/bluesky-api): What the Bluesky endpoints return, with examples.
- [Dailymotion API](https://truescrape.com/dailymotion-api): What the Dailymotion endpoints return, with examples.
- [Deezer API](https://truescrape.com/deezer-api): What the Deezer endpoints return, with examples.
- [eBay API](https://truescrape.com/ebay-api): What the eBay endpoints return, with examples.
- [Facebook API](https://truescrape.com/facebook-api): What the Facebook endpoints return, with examples.
- [Flickr API](https://truescrape.com/flickr-api): What the Flickr endpoints return, with examples.
- [GitHub API](https://truescrape.com/github-api): What the GitHub endpoints return, with examples.
- [Google API](https://truescrape.com/google-api): What the Google endpoints return, with examples.
- [Hackernews API](https://truescrape.com/hackernews-api): What the Hackernews endpoints return, with examples.
- [Instagram API](https://truescrape.com/instagram-api): What the Instagram endpoints return, with examples.
- [Kick API](https://truescrape.com/kick-api): What the Kick endpoints return, with examples.
- [Kwai API](https://truescrape.com/kwai-api): What the Kwai endpoints return, with examples.
- [Link-in-bio API](https://truescrape.com/link-in-bio-api): What the Link-in-bio endpoints return, with examples.
- [LinkedIn API](https://truescrape.com/linkedin-api): What the LinkedIn endpoints return, with examples.
- [Mashable API](https://truescrape.com/mashable-api): What the Mashable endpoints return, with examples.
- [Mastodon API](https://truescrape.com/mastodon-api): What the Mastodon endpoints return, with examples.
- [Mixcloud API](https://truescrape.com/mixcloud-api): What the Mixcloud endpoints return, with examples.
- [Odysee API](https://truescrape.com/odysee-api): What the Odysee endpoints return, with examples.
- [Okru API](https://truescrape.com/okru-api): What the Okru endpoints return, with examples.
- [PeerTube API](https://truescrape.com/peertube-api): What the PeerTube endpoints return, with examples.
- [Pinterest API](https://truescrape.com/pinterest-api): What the Pinterest endpoints return, with examples.
- [Reddit API](https://truescrape.com/reddit-api): What the Reddit endpoints return, with examples.
- [Redfin API](https://truescrape.com/redfin-api): What the Redfin endpoints return, with examples.
- [Rumble API](https://truescrape.com/rumble-api): What the Rumble endpoints return, with examples.
- [Snapchat API](https://truescrape.com/snapchat-api): What the Snapchat endpoints return, with examples.
- [SoundCloud API](https://truescrape.com/soundcloud-api): What the SoundCloud endpoints return, with examples.
- [Spotify API](https://truescrape.com/spotify-api): What the Spotify endpoints return, with examples.
- [Streamable API](https://truescrape.com/streamable-api): What the Streamable endpoints return, with examples.
- [Substack API](https://truescrape.com/substack-api): What the Substack endpoints return, with examples.
- [Telegram API](https://truescrape.com/telegram-api): What the Telegram endpoints return, with examples.
- [Threads API](https://truescrape.com/threads-api): What the Threads endpoints return, with examples.
- [TikTok API](https://truescrape.com/tiktok-api): What the TikTok endpoints return, with examples.
- [Truth Social API](https://truescrape.com/truthsocial-api): What the Truth Social endpoints return, with examples.
- [Twitch API](https://truescrape.com/twitch-api): What the Twitch endpoints return, with examples.
- [Utilities API](https://truescrape.com/utilities-api): What the Utilities endpoints return, with examples.
- [Vimeo API](https://truescrape.com/vimeo-api): What the Vimeo endpoints return, with examples.
- [Walmart API](https://truescrape.com/walmart-api): What the Walmart endpoints return, with examples.
- [X / Twitter API](https://truescrape.com/twitter-api): What the X / Twitter endpoints return, with examples.
- [YouTube API](https://truescrape.com/youtube-api): What the YouTube endpoints return, with examples.
- [Zillow API](https://truescrape.com/zillow-api): What the Zillow endpoints return, with examples.

## Free tools

- [YouTube transcript](https://truescrape.com/tools/youtube-transcript): Paste a video URL, get plain text, timestamped text, or an SRT file. Runs /v1/youtube/transcript.
- [YouTube channel viewer](https://truescrape.com/tools/youtube-channel-viewer): Look up subscribers, total views, links, and recent uploads for any channel. Runs /v1/youtube/channel.
- [YouTube video analyzer](https://truescrape.com/tools/youtube-video-analyzer): Views, likes, engagement rate, hashtags, and metadata for any video or Short. Runs /v1/youtube/video.
- [YouTube comment analyzer](https://truescrape.com/tools/youtube-comment-analyzer): Read a video’s first comments: most liked, most replied-to, questions, common words. Runs /v1/youtube/video/comments.
- [Bulk YouTube transcripts](https://truescrape.com/tools/bulk-youtube-transcripts): Paste a channel or a list of URLs and download every transcript at once. Runs /v1/youtube/transcript.
- [TikTok profile viewer](https://truescrape.com/tools/tiktok-profile-viewer): Look up followers, likes, bio and verification for any public TikTok profile. Runs /v1/tiktok/profile.
- [TikTok engagement rate](https://truescrape.com/tools/tiktok-engagement-rate-calculator): Average and median engagement rate over recent videos, with the formula shown. Runs /v1/tiktok/user-videos.
- [TikTok transcript](https://truescrape.com/tools/tiktok-transcript-extractor): Paste a TikTok video link, get its captions as text, timestamps, or SRT. Runs /v1/tiktok/transcript.
- [TikTok username checker](https://truescrape.com/tools/tiktok-username-checker): See whether a public TikTok profile exists for a handle. Runs /v1/tiktok/profile.
- [Instagram profile viewer](https://truescrape.com/tools/instagram-profile-viewer): Look up followers, posts, bio and verification for any public Instagram profile. Runs /v1/instagram/profile.
- [Instagram highlight viewer](https://truescrape.com/tools/instagram-highlight-viewer): List and play the highlight reels pinned to any public Instagram profile. Runs /v1/instagram/user-highlights.
- [LinkedIn profile viewer](https://truescrape.com/tools/linkedin-profile-viewer): See the public name, headline, followers and links of any LinkedIn profile. Runs /v1/linkedin/profile.
- [Snapchat profile viewer](https://truescrape.com/tools/snapchat-profile-viewer): Look up the public name, avatar and subscriber count of any Snapchat profile. Runs /v1/snapchat/profile.
- [Threads profile viewer](https://truescrape.com/tools/threads-profile-viewer): Look up the public bio, followers and links of any Threads profile. Runs /v1/threads/profile.
- [Bluesky profile viewer](https://truescrape.com/tools/bluesky-profile-viewer): Look up the bio, followers, following and post count of any Bluesky profile. Runs /v1/bluesky/profile.
- [Instagram reel downloader](https://truescrape.com/tools/instagram-reel-downloader): Paste a reel or video link, preview it, and save the file. Runs /v1/instagram/post.
- [Facebook video downloader](https://truescrape.com/tools/facebook-video-downloader): Paste a Facebook reel or video link, preview it, and save the file. Runs /v1/facebook/post.
- [X video downloader](https://truescrape.com/tools/x-video-downloader): Paste the link of an X post with a video, preview it, and save the file. Runs /v1/twitter/tweet.
- [Instagram profile picture downloader](https://truescrape.com/tools/instagram-profile-picture-downloader): Enter a handle, preview the profile picture, and save the image. Runs /v1/instagram/profile.
- [YouTube thumbnail downloader](https://truescrape.com/tools/youtube-thumbnail-downloader): Paste a video or Short link, preview the thumbnail, and save the largest size. Runs /v1/youtube/video.
- [Instagram photo downloader](https://truescrape.com/tools/instagram-photo-downloader): Paste a post link, preview the photo, and save the image. Runs /v1/instagram/post.
- [TikTok profile picture downloader](https://truescrape.com/tools/tiktok-profile-picture-downloader): Enter a handle, preview the profile picture, and save the image. Runs /v1/tiktok/profile.
- [Instagram thumbnail downloader](https://truescrape.com/tools/instagram-thumbnail-downloader): Paste a reel or post link, preview the cover image, and save it. Runs /v1/instagram/post.
- [X image downloader](https://truescrape.com/tools/x-image-downloader): Paste the link of an X post, preview its photos, and save them at original size. Runs /v1/twitter/tweet.
- [X GIF downloader](https://truescrape.com/tools/x-gif-downloader): Paste the link of an X post with a GIF, preview it, and save the MP4 X stores. Runs /v1/twitter/tweet.
- [X thumbnail downloader](https://truescrape.com/tools/x-thumbnail-downloader): Paste the link of an X post, preview its video’s cover image, and save it. Runs /v1/twitter/tweet.
- [Facebook thumbnail downloader](https://truescrape.com/tools/facebook-thumbnail-downloader): Paste a Facebook reel or video link, preview the cover image, and save it. Runs /v1/facebook/post.
- [TikTok thumbnail downloader](https://truescrape.com/tools/tiktok-thumbnail-downloader): Paste a TikTok video link, preview the cover image, and save it. Runs /v1/tiktok/video.
- [Dailymotion thumbnail downloader](https://truescrape.com/tools/dailymotion-thumbnail-downloader): Paste a Dailymotion video link, preview the cover image, and save it. Runs /v1/dailymotion/video.
- [Dailymotion subtitle downloader](https://truescrape.com/tools/dailymotion-subtitle-downloader): Paste a Dailymotion video link and save its captions as SRT, VTT or text. Runs /v1/dailymotion/video/transcript.
- [Streamable video downloader](https://truescrape.com/tools/streamable-video-downloader): Paste a Streamable link, preview the video, and save the MP4. Runs /v1/streamable/video.
- [Mashable video downloader](https://truescrape.com/tools/mashable-video-downloader): Paste a Mashable video link, preview it, and save the MP4. Runs /v1/mashable/video.
- [Flickr video downloader](https://truescrape.com/tools/flickr-video-downloader): Paste a Flickr video link, preview it, and save the MP4. Runs /v1/flickr/post.
- [Bilibili video downloader](https://truescrape.com/tools/bilibili-video-downloader): Paste a Bilibili video link and save the MP4, up to 720p. Runs /v1/bilibili/video.
- [OK.ru video downloader](https://truescrape.com/tools/okru-video-downloader): Paste an OK.ru video link, preview it, and save the largest file. Chrome and Edge only. Runs /v1/okru/video.
- [Vimeo video downloader](https://truescrape.com/tools/vimeo-video-downloader): Paste a Vimeo video link, preview it, and save an MP4 with sound. Runs /v1/vimeo/video.
- [Bluesky video downloader](https://truescrape.com/tools/bluesky-video-downloader): Paste a Bluesky post link, preview its video, and save an MP4 with sound. Runs /v1/bluesky/post.
- [Twitch profile viewer](https://truescrape.com/tools/twitch-profile-viewer): Look up the bio, followers and partner badge of any Twitch channel. Runs /v1/twitch/profile.
- [Twitch clip downloader](https://truescrape.com/tools/twitch-clip-downloader): Paste a Twitch clip link, preview it, and save the MP4. Runs /v1/twitch/clip.
- [Brand mention checker](https://truescrape.com/tools/brand-mentions): Recent mentions of a brand, product or domain across seven sites, in one list. Runs /v1/reddit/search.

## Product

- [Agents](https://truescrape.com/agents): Live context for your agent: competitors, mentions and markets. Add it in one line after getting a key: npx truescrape agent add claude-code. Public, logged-out data; checks cost credits, and failed or empty calls cost nothing.
- [Pricing](https://truescrape.com/pricing): Credit packs, what a credit buys, and the daily spend cap.
- [Brand mention monitoring](https://truescrape.com/mention-monitoring): Watch a brand across Reddit, Hacker News, Bluesky, YouTube, Threads, Instagram, TikTok, Dailymotion, PeerTube and Odysee; 1 credit per platform per check, nothing per mention. PeerTube and Odysee sort by match, not date, so a busy term may rarely surface new videos.
- [How to track brand mentions without a subscription](https://truescrape.com/blog/track-brand-mentions-without-a-subscription): What the paid mention tools charge, and what a per-check monitor costs instead.
- [Free tools](https://truescrape.com/tools): Browser tools that run against the same API, with no key required.
- [Changelog](https://truescrape.com/changelog): Every release: new platforms, endpoints, free tools and dashboard features.
- [Vendor comparisons and alternatives](https://truescrape.com/compare): How we compare to other social data and mention-monitoring tools, including where they win, and alternatives pages for people leaving one.
- [Blog](https://truescrape.com/blog): Scraping law, proxies, and working with platform data without an API key.

## Comparisons and alternatives

- [Brand monitoring tools compared](https://truescrape.com/brand-monitoring-tools): Brand24, Mention and Awario for X, news and sentiment; F5Bot and Syften for Reddit and HN; Octolens and TrueScrape for webhooks. Prices from each vendor.
- [Apify vs TrueScrape](https://truescrape.com/compare/apify): Apify rents a platform and a marketplace of scrapers; we run fixed social endpoints behind one schema. Priced, dated, and plain about which you want.
- [Bright Data vs TrueScrape](https://truescrape.com/compare/bright-data): Bright Data is the largest, most legally battle-tested vendor here. Where that matters, where it does not, and what they do better than us.
- [EnsembleData vs TrueScrape](https://truescrape.com/compare/ensembledata): EnsembleData sells a monthly plan whose daily unit allowance resets each night; our prepaid credits never expire. Priced, dated, with where they lead.
- [SociaVault vs TrueScrape](https://truescrape.com/compare/sociavault): SociaVault bills only successful responses on monitored TikTok and Instagram endpoints. What about $4.83 per 1,000 buys, and where we are behind.
- [F5Bot vs TrueScrape for brand mention alerts](https://truescrape.com/compare/f5bot): F5Bot is free, fast and email-first for Reddit, Hacker News and Lobsters. What its $12.99 and $49.99 plans add, and what it cannot see.
- [Syften vs TrueScrape for community mention monitoring](https://truescrape.com/compare/syften): Syften watches forums, GitHub and podcasts, not just Reddit. What $29.95, $49.95 and $119.95 a month buy, and why webhooks wait for PRO.
- [Octolens vs TrueScrape for developer brand monitoring](https://truescrape.com/compare/octolens): Octolens covers X, LinkedIn, GitHub and reviews with AI relevance and sentiment. $159 a month billed annually buys 10 keywords and an hourly refresh.
- [Brand24 vs a mention-monitoring API](https://truescrape.com/compare/brand24): Brand24 is full social listening from $199 a month billed annually: sentiment, X, Facebook, news and podcasts. API access is $149 extra.
- [Mention vs a mention-monitoring API](https://truescrape.com/compare/mention): Mention sells one Company plan with sentiment, reports, review sites and a team workspace; API access and historical data are paid add-ons.
- [Awario vs a mention-monitoring API](https://truescrape.com/compare/awario): Awario starts at $29 to $49 a month for 3 topics and 30,000 mentions, with X, Facebook, news and an API on every plan; TikTok, Threads and HN are not listed.
- [PhantomBuster vs TrueScrape](https://truescrape.com/compare/phantombuster): PhantomBuster automates through your own LinkedIn and social accounts; we serve public, logged-out data through one API. Priced and dated.
- [Data365 vs TrueScrape](https://truescrape.com/compare/data365): Data365 sells a monthly plan per social network with very large credit volumes; we sell prepaid credits across every platform. Priced and dated.
- [ScrapeCreators alternatives](https://truescrape.com/alternatives/scrapecreators): Apify, EnsembleData, SociaVault, Bright Data, Data365 and TrueScrape: entry price, failure billing, free credits and coverage, from each pricing page.
- [F5Bot alternatives](https://truescrape.com/alternatives/f5bot): Syften, Octolens, ForumScout, Brand24 and TrueScrape compared on price, Reddit and HN, TikTok and Instagram, X and LinkedIn, webhooks and sentiment.
- [Brand24 alternatives](https://truescrape.com/alternatives/brand24): Mention, Awario, Octolens, Syften and TrueScrape compared on entry price, sentiment, X, Facebook, news, TikTok, Hacker News and API access.
- [Mention alternatives](https://truescrape.com/alternatives/mention): Brand24, Awario, Octolens, Syften, F5Bot and TrueScrape on entry price, X, LinkedIn, sentiment, Hacker News, TikTok, API and free tier, from each pricing page.

## Optional

- [Endpoint catalogue](https://truescrape.com/llms-full.txt): Every endpoint, generated from the registry that serves them.
- [OpenAPI spec](https://truescrape.com/openapi.json): The same catalogue as OpenAPI, with x-credit-cost on every operation.
- [Pricing as markdown](https://truescrape.com/pricing.md): Tiers, the volume ladder and what a credit buys, for programmatic comparison.