Quickstart

extractr is one API for scraped, structured data across industries — music, social, finance, restaurants, games. Every endpoint is priced in credits, charged per successful request. New accounts start with 1,000 free credits (£1 worth), enough for hundreds of requests.

1. Get an API key

Create a key in the dashboard. Keys look like ext_live_… and are shown once, at creation — store it somewhere safe.

2. Make your first request

Pass the key in the X-API-Key header. Here's a live stock quote — it costs 1 credit:

curl "https://api.extractr.dev/finance/quote?symbol=AAPL" \
  -H "X-API-Key: ext_live_YOUR_KEY"

3. Read the credit headers

Every successful (2xx) response tells you what it cost and what you have left:

HTTP/2 200
X-Credits-Charged: 1
X-Credits-Balance: 999
Content-Type: application/json

• X-Credits-Charged — credits deducted for this request.
• X-Credits-Balance — your balance after the deduction.

Credits are only charged on success. Errors — including validation failures and rate limits — are free.

Next steps