Authentication
Every /api/v1 request needs a secret key from the dashboard. Send it as a bearer token or as X-API-Key.
Headers
Use either header. Keys start with sk_live_.
Authorization: Bearer sk_live_YOUR_KEY
X-API-Key: sk_live_YOUR_KEY
Example
curl "https://speckinsights.com/api/v1/demographics?ip=8.8.8.8" \ -H "Authorization: Bearer sk_live_YOUR_KEY"
Copy the secret once. Speck stores a hash of each key. If you lose it, revoke the key and create another.
Quota
The 7-day trial includes 1,000 successful calls. After that, volume is billed on one paid plan. Successful responses count, including cached hits. 4xx and 5xx do not. Exceeding the quota returns 429. An expired trial returns 402. See pricing.