Developer API · ZIP demographics
IP to ZIP to the people who live there.
Speck Insights turns a public IP into geolocation, a U.S. ZIP code, and neighborhood demographics — so products can understand who is on the other end of a request.
- 01 Public IP
- 02 ZIP code
- 03 Demographics
Try a lookup
GET /api/demo/lookup20 demo lookups per hour. On localhost, enter a public IP such as 8.8.8.8.
Routes
Call them separately, or run the full IP → ZIP → demographics chain in one request.
GET /api/v1/geoIP geolocation
Resolve city, region, country, coordinates, ISP, and ZIP/postal code for any public IPv4 or IPv6 address. Repeat lookups are cached.
GET /api/v1/geo?ip=8.8.8.8 Authorization: Bearer sk_live_…
GET /api/v1/zipZIP → demographics
Neighborhood-scale population, income, education, housing, labor, and race/ethnicity for a 5-digit U.S. ZIP code.
GET /api/v1/zip?zip=10001 X-API-Key: sk_live_…
GET /api/v1/demographicsIP → ZIP → demographics
The full pipeline. Use it for audience tools, content targeting, or anything that needs neighborhood-scale demographics from a request IP.
GET /api/v1/demographics?ip=8.8.8.8 X-API-Key: sk_live_…
What a ZIP returns
Missing or suppressed values come back as null.
| Population | Total, median age, households |
|---|---|
| Income | Median household, per capita, poverty rate |
| Education | Share with bachelor’s or higher |
| Housing | Units, owner occupancy, median value and rent |
| Labor | Civilian labor force and unemployment |
| Race / ethnicity | Race categories plus Hispanic/Latino |