Quick start

Create a key and resolve an IP address to U.S. demographics in three steps.

1. Create an API key

Create an account, open the dashboard, and create a key. Copy it immediately — Speck stores only a hash and shows the secret once.

New accounts start with a 7-day trial (1,000 successful calls). See pricing.

Call GET /api/v1/demographics with your key. Pass a public IPv4 or IPv6 address, or omit ip to look up the caller.

curl "https://speckinsights.com/api/v1/demographics?ip=8.8.8.8" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Every successful demographics lookup returns four top-level fields:

Field	What you get
`ip`	The public address that was resolved.
`geo`	City, region, country, ZIP, coordinates, timezone, and ISP.
`demographics`	Population, income, education, housing, labor, and race/ethnicity for that ZIP — or `null` when none apply.
`notes`	Why demographics are missing, if they are: no ZIP, non-U.S. IP, or no match for that ZIP.