# Perceptlayer

> One API key for structured JSON from about 250 websites, as a REST API or an MCP server for AI agents.

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

## Guides

### Get started

- [Introduction](https://docs.perceptlayer.com/index.md): One API key for structured JSON from about 250 websites, as a REST API or an MCP server for AI agents.
- [Quick start](https://docs.perceptlayer.com/quickstart.md): Create an API key and make your first call.
- [Authentication](https://docs.perceptlayer.com/authentication.md): Send your API key in the X-API-Key header.

### Using the API

- [Requests and responses](https://docs.perceptlayer.com/requests.md): URL format, parameters, response bodies and headers.
- [Credits](https://docs.perceptlayer.com/credits.md): What a call costs, free credits and credit packs.
- [Errors](https://docs.perceptlayer.com/errors.md): Error codes, what they mean and what to do about them.
- [Rate limits](https://docs.perceptlayer.com/rate-limits.md): Requests a minute per account, and what happens over the limit.
- [Restricted endpoints](https://docs.perceptlayer.com/restricted-endpoints.md): Endpoints that return social, personal or SEO data need an extra set of terms.

### AI agents

- [AI agents (MCP)](https://docs.perceptlayer.com/ai-agents.md): Give an AI agent the whole catalogue through our MCP server.

- [API reference (1660 pages)](https://docs.perceptlayer.com/_llms/api-reference.txt): Documentation for API reference.

## OpenAPI Specs

- [openapi](/openapi.json)

## Optional

- [Dashboard](https://perceptlayer.com/dashboard)
- [OpenAPI file](https://perceptlayer.com/openapi.json)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [API reference (1660 pages)](https://docs.perceptlayer.com/_llms/api-reference.txt): Documentation for API reference.
- [API reference / Real estate (470 pages)](https://docs.perceptlayer.com/_llms/api-reference/real-estate.txt): Documentation for API reference / Real estate.
- [API reference / Cars (188 pages)](https://docs.perceptlayer.com/_llms/api-reference/cars.txt): Documentation for API reference / Cars.
- [API reference / Social media (323 pages)](https://docs.perceptlayer.com/_llms/api-reference/social-media.txt): Documentation for API reference / Social media.
- [API reference / Travel (191 pages)](https://docs.perceptlayer.com/_llms/api-reference/travel.txt): Documentation for API reference / Travel.


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