Authentication

API keys

Every request to ProductParse requires an API key passed as a Bearer token in the Authorization header.

Authorization: Bearer pp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keys are prefixed with pp_live_ for production and pp_test_ for test mode (coming soon).

Getting your key

1. Create an account or log in
2. Your key is shown immediately in the dashboard
3. Copy it — it is only shown once in full. Rotate it from the dashboard if lost.

Passing the key

curl

curl -X POST https://api.productparse.dev/v1/parse \
  -H "Authorization: Bearer $PP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/product"}'

Node.js / fetch

const res = await fetch('https://api.productparse.dev/v1/parse', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.PP_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ url: 'https://example.com/product' }),
})

Python / httpx

import httpx, os

client = httpx.Client(
    base_url="https://api.productparse.dev",
    headers={"Authorization": f"Bearer {os.environ['PP_API_KEY']}"},
)

Rate limits

Limits are applied per API key, per rolling 60-second window.

When you exceed the rate limit, the API returns 429 Too Many Requests with a Retry-After header indicating when to retry.

Key rotation

To rotate your key:

1. Go to the API Keys section of your dashboard
2. Click Rotate key — a new key is issued immediately
3. Your old key is invalidated after 60 seconds (grace period for in-flight requests)

Environments

Test-mode keys do not consume quota and return fixture responses, making them suitable for CI environments.