Credits & pricing
1 credit = £0.001. Pay per request, only on success.
extractr is credit-based: 1 credit = £0.001 (1,000 credits per £1). Every endpoint declares a fixed price, charged only on successful (2xx) responses. New accounts start with 1,000 free credits, and credits never expire.
Each successful response returns two headers:
X-Credits-Charged: 2
X-Credits-Balance: 4998Per-endpoint costs
Prices come straight from the OpenAPI spec (the x-credits extension) — each endpoint's reference page repeats its own cost.
| Endpoint | Description | Credits |
|---|---|---|
GET /catalog | Provider catalog | Free |
GET /health | Health check | Free |
GET /spotify/search | Search the catalog | 1 |
GET /spotify/get_track | Get track metadata | 2 |
GET /spotify/get_artist | Get artist profile | 2 |
GET /spotify/get_playlist | Get playlist contents | 3 |
POST /spotify/download | Request a track download | 10 |
GET /facebook/profile | Get page/profile overview | 2 |
GET /facebook/comments | Get post comments | 3 |
GET /facebook/page_posts | Get recent page posts | 5 |
GET /finance/quote | Get latest quote | 1 |
GET /finance/company | Get company profile | 2 |
GET /finance/news | Get ticker news | 2 |
GET /finance/history | Get OHLCV history | 3 |
GET /restaurants/search | Search restaurants | 2 |
GET /restaurants/details | Get restaurant details | 2 |
GET /restaurants/reviews | Get restaurant reviews | 3 |
GET /restaurants/menu | Get full menu | 5 |
GET /steam/app | Get app details | 1 |
GET /steam/player_count | Get live player count | 1 |
GET /steam/search | Search the store | 1 |
GET /steam/reviews | Get app reviews | 2 |
Management routes (/manage/*, used by the dashboard) are always free.
Top-up packages
Buy credits from the billing page. Larger packages include bonus credits:
| Package | Price | Credits | Bonus | You receive |
|---|---|---|---|---|
| Starter | £5 | 5,000 | — | 5,000 |
| Growth (most popular) | £20 | 20,000 | +2,000 | 22,000 |
| Scale | £50 | 50,000 | +10,000 | 60,000 |
Payment is handled by Stripe Checkout. Credits land instantly and never expire.
Auto top-up
Never hit a 402 in production. With auto top-up enabled, when your balance drops below a threshold we automatically buy your chosen package with the card saved from your first checkout:
- Default threshold: 1,000 credits.
- Default package: Growth (22,000 credits).
- Configure or disable it any time from the billing page.
If you run out of credits without auto top-up, requests fail with 402 insufficient_credits — nothing is charged, and requests succeed again as soon as you top up.