Authentication

Authenticate requests with a Bearer API key.

Peep authenticates every request with a secret API key passed as a Bearer token. Create and revoke keys in your developer dashboard. Keys are shown once at creation and look like peep_live_•••.

text

Authorization: Bearer peep_live_xxx

Keep Keys Secret

Treat your key like a password. Never ship it in client-side code or a public repo — call Peep from your backend. A leaked key can spend your Peep Card balance.

Example

bash

curl -X POST https://peep.shownomore.com/api/v1/scrape \
  -H "Authorization: Bearer peep_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com"
}'

An invalid or missing key returns 401 with code INVALID_API_KEY — see Errors.