Quick start

Create an account

Sign up with your email and open the link we send you. The link works once and expires after 15 minutes.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).

Create a key

In the dashboard, create a key. It starts with sk_live_ and is shown once, so store it somewhere safe.

export API_KEY="sk_live_..."

Make a call

Search Google Maps for restaurants in New York:

curl "https://api.perceptlayer.com/v1/google-maps/simple-search?query=restaurants+in+new+york" \
  -H "X-API-Key: $API_KEY"

import os
import requests

response = requests.get(
    "https://api.perceptlayer.com/v1/google-maps/simple-search",
    params={"query": "restaurants in new york"},
    headers={"X-API-Key": os.environ["API_KEY"]},
    timeout=60,
)
response.raise_for_status()
print(response.headers["X-Credits-Used"], response.json())

const url = new URL("https://api.perceptlayer.com/v1/google-maps/simple-search");
url.searchParams.set("query", "restaurants in new york");

const response = await fetch(url, {
  headers: { "X-API-Key": process.env.API_KEY },
  signal: AbortSignal.timeout(60_000),
});
if (!response.ok) throw new Error((await response.json()).error.message);
console.log(response.headers.get("X-Credits-Used"), await response.json());

Read the response

The body is the data itself:

{
  "items": [
    {
      "name": "Altair Restaurant NYC",
      "review_count": 1225,
      "rating": 4.8,
      "website": "https://www.altairnyc.com/",
      "full_address": "351 W 38th St, New York, NY 10018, United States"
    }
  ]
}

Shortened from a recorded response. The X-Credits-Used header says what the call cost, and X-Credits-Remaining shows your balance.

Next steps

Find an endpoint

Every source and endpoint, with a playground.

Connect an agent

Use the catalogue from Claude Code, Cursor or VS Code.

Last modified on October 23, 2026

Get started

Using the API

AI agents

Next steps

Find an endpoint

Connect an agent

​Next steps

Find an endpoint

Connect an agent

Next steps