> ## Documentation Index
> Fetch the complete documentation index at: https://docs.perceptlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Perceptlayer is a web data API: one key for structured JSON from about 250 websites. Base URL https://api.perceptlayer.com.
> Send the key in the X-API-Key header. GET parameters go in the query string; POST parameters in a JSON body.
> A successful call costs the credits on its endpoint (X-Credits-Used); failed calls cost nothing. Errors are {"error": {"code", "message", "request_id"}}.
> AI agents can use every endpoint through the MCP server at https://api.perceptlayer.com/mcp (tools search_endpoints, get_endpoint, call_endpoint), with Authorization: Bearer <key>.
> Get a free key at https://perceptlayer.com/signup.

# Credits

> What a call costs, free credits and credit packs.

A successful call costs the credits shown on its endpoint: one for nearly all of them. Calls that fail cost nothing, whatever the reason: invalid parameters, no data for the query, rate limits or a source outage.

Every response says what it cost in `X-Credits-Used` and what's left in `X-Credits-Remaining`.

## Free credits

New accounts get 1,000 free credits once they verify their email, topped back up each month until the first purchase. The free rate is 1 request a second (60 a minute).

## Credit packs

Packs are prepaid, with no subscription. Credits from packs last 12 months from purchase. Credits bought at a faster rate are spent first, then the oldest.

| Pack | Price | Credits | Per 1,000 calls | Requests a second |
| - | - | - | - | - |
| Starter | \$15 | 10,000 | \$1.50 | 5 |
| Build | \$59 | 50,000 | \$1.18 | 5 |
| Growth | \$199 | 200,000 | \$1.00 | 5 |
| Pro | \$399 | 500,000 | \$0.80 | 5 |
| Scale | \$699 | 1,000,000 | \$0.70 | 10 |
| Volume | \$2,999 | 5,000,000 | \$0.60 | 20 |
| Volume 10M | \$5,999 | 10,000,000 | \$0.60 | 25 |
| Volume 25M | \$14,999 | 25,000,000 | \$0.60 | 25 |
| Volume 50M | \$29,999 | 50,000,000 | \$0.60 | 50 |

Prices in US dollars. See [pricing](https://perceptlayer.com/pricing) for faster rates and the credit calculator.

Buy packs in [billing](https://perceptlayer.com/dashboard/billing). When the balance runs out, calls return `402 insufficient_credits`, free, until you add more. You can get an email when the balance runs low, in [notifications](https://perceptlayer.com/dashboard/notifications).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.