Geo

Location only — city, region, country, coordinates, ISP, and ZIP/postal code when you do not need demographics.

Endpoint:GET /api/v1/geo

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/geo?ip=8.8.8.8" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Response

Field	What it includes
`ip`	The public address that was resolved.
`city`, `region`, `country`	Place names, plus `region_code` and `country_code`.
`postal_code`	ZIP or postal code when the provider returns one.
`latitude`, `longitude`	Approximate coordinates.
`timezone`, `isp`, `org`	Network metadata when available.

Example

{
  "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"
}

Illustrative payload. Values vary by IP.