Credits & the Peep Card
How credits are priced, shared, and tracked.
Usage is billed in credits from your Peep Card — a single balance that powers everything: the dashboard playground, the REST API, and the MCP server all draw from the same pool. New accounts start with 500 credits.
Costs By Endpoint
| Parameter | Type | Description |
|---|---|---|
Scrape | 1 + add-ons | 1 base; +4 for AI (json / changeTracking); +4 if a stealth proxy is used. |
Crawl | 1 / page | Charged per page scraped as the crawl runs. Creating the crawl is free. |
Map | 1 | Flat, regardless of how many URLs are returned. |
Search | 2 / 10 results | Two credits per ten results requested. |
Batch Scrape | 1 / URL | Charged per child URL as it runs. |
Extract | 5 / URL | AI structured extraction per URL. |
Agent | maxSources + 4 | Sources harvested plus a planning overhead. |
Credits | 0 | Reading your balance is always free. |
Tracking Spend
Every response includes a creditsUsed (or creditsReserved) field, plus response headers:
X-Peep-Credits-Used— credits spent (or reserved) by this requestX-Peep-Credits-Remaining— your live Peep Card balance
Check Your Balance
GET
/api/v1/creditsFreeReturns your balance, plan tier, and recent ledger entries (debits and grants).
bash
curl -X GET https://peep.shownomore.com/api/v1/credits \
-H "Authorization: Bearer peep_live_xxx"Running Out
When your balance can't cover a request, Peep returns
402 with code INSUFFICIENT_CREDITS. Failed jobs are refunded automatically.