Get started

Read stored iOS competitor evidence from your backend, a script, or an AI agent.

Last reviewed October 19, 2026Download Markdown ↓

Which surface to use

HTTP and MCP read the same catalogue. Pick the surface that matches the client.

Surface	Credential	Use it for
REST API	API key	Read analytics-style catalogue data, save items, and send commands from your backend
MCP	OAuth or the same API key	Ask an assistant about competitors, creatives, keywords, and charts

Base URL

Every v1 route hangs off this origin. Send the tenancy selector with the credential.

https://api.peekpanda.com/v1/

Authenticate requests

Send a PeekPanda API key as a bearer token. Create one under Account → API keys. It is shown once. Do not put it in frontend code or a public repository.

Create an API key →

Authorization: Bearer YOUR_API_KEY

Try a read

Search stored iOS calorie-tracking competitors. Responses are paginated with an opaque next cursor. Keep the original filters when you follow it.

curl --get 'https://api.peekpanda.com/v1/competitors' \
  --header "Authorization: Bearer $PEEKPANDA_TOKEN" \
  --header 'x-genviral-tenancy: personal' \
  --data-urlencode 'platform=ios' \
  --data-urlencode 'search=calorie' \
  --data-urlencode 'limit=24'

Errors

Failed requests return an HTTP status and a safe error body. Invalid input is 400, a missing credential is 401, a missing subscription is 402, a missing scope is 403, a missing record is 404, a conflict is 409, and a throttle is 429. Honor Retry-After when it is present. A 429 with daily_call_limit means the plan's API and MCP calls for the day are used: 30 calls a day on Peek and 1,000 on Panda, reset at 00:00 UTC.

Errors and retries →

Next steps

Connect an assistant, or open the endpoint index and follow one operation.

Get started with MCP →

AI agent or LLM? Read this page as markdown