Location

Location Enrichment API

Live free tier 33,099 ZIP profiles imported; SimpleMaps source attribution required.

Overview

ZIP, city, county, coordinate, timezone, and metro enrichment for U.S. locations.

Base URL

https://apidatasets.com/api/v1

Endpoints

GET/api/v1/geo/city

2 credits

Find seeded ZIP profiles by city and optional state.

{
  "data": {
    "type": "city_zip_search"
  },
  "meta": {
    "credits_used": 2
  }
}

GET/api/v1/geo/county/{fips}

2 credits

Find seeded ZIP profiles by county FIPS.

{
  "data": {
    "type": "county_zip_lookup"
  },
  "meta": {
    "credits_used": 2
  }
}

GET/api/v1/geo/enrich

2 credits

Enriched ZIP profile response with source confidence.

{
  "data": {
    "type": "zip_enrichment"
  },
  "meta": {
    "credits_used": 2
  }
}

GET/api/v1/geo/timezone

1 credits

Resolve a timezone using the nearest ZIP centroid.

{
  "data": {
    "type": "nearest_timezone"
  },
  "meta": {
    "credits_used": 1
  }
}

GET/api/v1/geo/zip/{zip_code}

1 credits

Lookup city, county, timezone, coordinates, and source metadata.

{
  "data": {
    "type": "zip_profile_lookup"
  },
  "meta": {
    "credits_used": 1
  }
}

Authentication

Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEY

All /api/v1 routes require API key authentication and return consistent JSON errors.

Source and freshness

Location profiles use the SimpleMaps US ZIP Codes Basic database with visible attribution, plus a small manual fallback for high-demand non-ZCTA ZIP examples.

U.S. Census Gazetteer Public U.S. government data. SimpleMaps US ZIP Codes Basic Free Basic database requires visible link attribution to https://simplemaps.com/data/us-zips.

Tax data is reference data only and does not constitute tax, legal, accounting, or financial advice.