Demographics

The product endpoint. Send a public IPv4 or IPv6 address and get location plus U.S. demographics for that ZIP in one request.

Endpoint:GET /api/v1/demographics

Query

Name	Required	Description
`ip`	No	Public IPv4 or IPv6 address. Omit it to look up the caller.

Request

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

Response

Non-U.S. IPs still return geo. demographics is null and notes explains why. Missing or suppressed census values come back as null.

Field	What it includes
`ip`	The public address that was resolved.
`geo`	City, region, country, ZIP/postal code, coordinates, timezone, ISP.
`demographics`	ZIP census payload, or `null` when none apply.
`notes`	Why demographics are missing, if they are.

What demographics includes

Group	Fields
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

Example

{
  "ip": "8.8.8.8",
  "geo": {
    "ip": "8.8.8.8",
    "city": "Mountain View",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "postal_code": "94043",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "isp": "Google LLC",
    "org": "Google Public DNS",
    "source": "ipinfo"
  },
  "demographics": {
    "zipcode": "94043",
    "name": "Mountain View, CA",
    "vintage": "2023",
    "population": {
      "total": 31442,
      "median_age": 35.2,
      "households": 13210
    },
    "income": {
      "median_household": 161250,
      "per_capita": 89210,
      "poverty_rate": 6.4
    },
    "education": {
      "bachelors_or_higher_pct": 72.1
    },
    "labor": {
      "labor_force": 19840,
      "unemployment_rate": 3.8
    },
    "housing": {
      "units": 14102,
      "owner_occupied_pct": 42.5,
      "median_home_value": 1850000,
      "median_gross_rent": 2850
    },
    "race_ethnicity": {
      "white": 48.2,
      "black": 2.1,
      "american_indian": 0.4,
      "asian": 33.6,
      "pacific_islander": 0.3,
      "other": 6.8,
      "two_or_more": 8.6,
      "hispanic_or_latino": 18.9
    }
  },
  "notes": []
}

Illustrative payload. Values vary by IP.