extractr docs

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: 4998

Per-endpoint costs

Prices come straight from the OpenAPI spec (the x-credits extension) — each endpoint's reference page repeats its own cost.

EndpointDescriptionCredits
GET /catalogProvider catalogFree
GET /healthHealth checkFree
GET /dice/get_citiesList supported cities1
GET /dice/searchUnified event/artist/venue search2
GET /dice/list_eventsFiltered event list2
GET /dice/get_eventEvent details + ticket pricing2
GET /dice/discoveryDiscovery feed near a point3
GET /ra/areasList areas (cities/regions)1
GET /ra/searchGlobal RA search2
GET /ra/event_listingsEvent listings for an area2
GET /ra/get_eventGet event detail2
GET /ra/event_ticketsGet ticket tiers for an event2
GET /ticketmaster/search_suggestType-ahead search suggestions1
GET /ticketmaster/search_eventsFree-text event search2
GET /ticketmaster/get_eventGet event detail2
GET /ticketmaster/get_ticket_selectionGet ticket selection & pricing3

Management routes (/manage/*, used by the dashboard) are always free.

Top-up packages

Buy credits from the billing page. Larger packages include bonus credits:

PackagePriceCreditsBonusYou receive
Starter£55,0005,000
Growth (most popular)£2020,000+2,00022,000
Scale£5050,000+10,00060,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.

On this page