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

# Restricted endpoints

> Endpoints that return social, personal or SEO data need an extra set of terms.

Endpoints that return social, personal or SEO data are marked **Restricted** in the API reference. They return `403 restricted_endpoint` until you accept the [restricted-endpoint terms](https://perceptlayer.com/legal/restricted-endpoints).

To accept them, open [your account](https://perceptlayer.com/dashboard/account) in the dashboard. Restricted endpoints work as soon as you do, for every key on the account and through the MCP server.

Restricted endpoints cost credits like any other, and failed calls are still free.


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