# 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.** Upstream blocks, timeouts, rate limits, 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

- [Documentation](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.

## Product

- [Pricing](https://truescrape.com/pricing): Credit packs, what a credit buys, and the daily spend cap.
- [Free tools](https://truescrape.com/tools): Browser tools that run against the same API, with no key required.
- [Vendor comparisons](https://truescrape.com/compare): How we compare to other social data APIs, including where they win.
- [Blog](https://truescrape.com/blog): Scraping law, proxies, and working with platform data without an API key.

## 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.