Quick start

Create a key. Call GET /demographics.

1. Create an API key

Create an account, open the dashboard, create a key. Copy it immediately — shown once, hash stored.

7-day trial (1,000 successful calls). See pricing.

GET /api/v1/demographics with a key. Pass ip, zip, lat+lng, city+state, or address. Omit the query to use the caller IP.

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

Success returns:

Field	Returns
`ip`	The public address that was resolved, or `null`.
`geo`	City, region, country, ZIP, coordinates, timezone, and ISP.
`demographics`	Population, income, education, housing, labor, race/ethnicity — or `null`.
`jobs`	Workplace vs residence jobs, industry, commute — or `null`. See jobs.
`notes`	Why a block is missing, if it is.
`resolution`	Starter and Census geography.