> ## 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.

# API reference

> Every endpoint, grouped by area and source, with a playground.

The reference is generated from our [OpenAPI file](https://perceptlayer.com/openapi.json), which also works with Postman and code generators.

## Base URL

```
https://api.perceptlayer.com
```

## Authentication

Send your key in the `X-API-Key` header. See [Authentication](https://docs.perceptlayer.com/authentication.md).

## Endpoints

248 sources and 1,659 endpoints, grouped by area:

| Area | Sources | Endpoints |
| - | - | - |
| Search engines | 26 | 66 |
| Real estate | 54 | 470 |
| Cars | 39 | 188 |
| Social media | 39 | 323 |
| Marketplaces | 27 | 164 |
| Apps and media | 8 | 125 |
| Travel | 26 | 191 |
| Jobs | 13 | 51 |
| Web and SEO | 7 | 35 |
| Reviews | 9 | 46 |

Each endpoint page lists its parameters, its cost in credits and the errors it can return. Pages marked **Restricted** need the [restricted-endpoint terms](https://docs.perceptlayer.com/restricted-endpoints.md).

## Playground

Every endpoint page has a playground. Paste your key into it and send a request: it runs against the live API and spends credits from your balance like any other call, so a failed call costs nothing. You can also run endpoints from the [dashboard](https://perceptlayer.com/dashboard/endpoints) without pasting a key.


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