Authentication

All API endpoints (except the public snapshot listing) require authentication via an API key.

Get an API key

1. Create an account at community.popcorntime.app
2. Accept the Terms of Service
3. Go to API Keys and create a key
4. Copy the key — it’s only shown once

Your key looks like: pt_live_ac7f5e83b2d1...

Using your key

Include the key in the Authorization header:

curl -H "Authorization: Bearer pt_live_your_key_here" \
  https://api.popcorntime.app/v1/rankings?country=US

Or use the X-API-Key header:

curl -H "X-API-Key: pt_live_your_key_here" \
  https://api.popcorntime.app/v1/rankings?country=US

Error responses

Status	Meaning
401	Missing or invalid API key
429	Rate limit exceeded (60 req/min)

{ "error": "Missing API key. Include `Authorization: Bearer pt_live_...` header." }

Key management

• Each account is limited to 1 active key
• You can revoke and recreate keys at any time
• Keys never expire unless revoked
• Usage stats are available on the Stats page