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.

  1. 01 Public IP
  2. 02 ZIP code
  3. 03 Demographics

Try a lookup

GET /api/demo/lookup

20 demo lookups per hour. On localhost, enter a public IP such as 8.8.8.8.

02

Routes

Call them separately, or run the full IP → ZIP → demographics chain in one request.

  1. GET /api/v1/geo

    IP 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_…
  2. GET /api/v1/zip

    ZIP → 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_…
  3. GET /api/v1/demographics

    IP → 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_…
03

What a ZIP returns

Missing or suppressed values come back as null.

PopulationTotal, median age, households
IncomeMedian household, per capita, poverty rate
EducationShare with bachelor’s or higher
HousingUnits, owner occupancy, median value and rent
LaborCivilian labor force and unemployment
Race / ethnicityRace categories plus Hispanic/Latino