$1.50/1k: US Zipcode -> City Name, State, Lat/Lng, and more

Get detailed location data including city, state, coordinates, and population from US ZIP codes.

Simply provide a list of ZIP codes and get back structured location data for each one.

No login required. No cookies needed. Pay-per-event pricing.

Why Choose This Actor?

"Enrich your data with US location information in seconds"

Our US ZIP Code provides:

• Very Fast Responses: We made sure it doesn't take up all day. Parallel processing (up to 4 concurrent requests) for large batches
• Cost-Effective: Pay only for the ZIP codes you look up: $1.50 / 1k zip codes
• Rich Data: Get city, state, coordinates, population, and more

Usage Examples

Resolve a Single ZIP Code

{
  "zipcodes": ["10001"]
}

Resolve Multiple ZIP Codes

{
  "zipcodes": ["90210", "10001", "60601"]
}

Returns:

{
  "zip": "00601",
  "lat": "18.18027",
  "lng": "-66.75266",
  "city": "Adjuntas",
  "state_id": "PR",
  "state_name": "Puerto Rico",
  "zcta": "TRUE",
  "parent_zcta": "",
  "population": "16669",
  "density": "99.9",
  "county_fips": "72001",
  "county_name": "Adjuntas",
  "county_weights": "{\"72001\": 98.74, \"72141\": 1.26}",
  "county_names_all": "Adjuntas|Utuado",
  "county_fips_all": "72001|72141",
  "imprecise": "FALSE",
  "military": "FALSE",
  "timezone": "America/Puerto_Rico",
  "error": null
}

Input Parameters

Parameter	Type	Required	Default	Description
zipcodes	array	Yes	-	List of US ZIP codes to resolve

Output Fields

Field	Type	Description
zip	string	ZIP code
lat	string	Latitude
lng	string	Longitude
city	string	City name
state_id	string	State abbreviation (e.g., "CA", "PR")
state_name	string	Full state name
zcta	string	Is this a ZCTA (ZIP Code Tabulation Area) - "TRUE"/"FALSE"
parent_zcta	string	Parent ZCTA if applicable
population	string	Population estimate
density	string	Population density per sq mile
county_fips	string	Primary county FIPS code
county_name	string	Primary county name
county_weights	string	JSON object with county FIPS and percentage weights
county_names_all	string	All county names (pipe-separated)
county_fips_all	string	All county FIPS codes (pipe-separated)
imprecise	string	Location is imprecise - "TRUE"/"FALSE"
military	string	Is military ZIP code - "TRUE"/"FALSE"
timezone	string	Timezone (e.g., "America/New_York")
error	null/string	Error message if lookup failed

Pricing

Cost	Description
$0.0001 / start	Charged per actor run
$1.50 / 1,000 zip codes	Charged per ZIP code returned

API Integration

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("zen-studio/us-zipcode-to-city-name-state-lat-lng").call(
    run_input={
        "zipcodes": ["90210", "10001", "60601", "02134"]
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['zip']}: {item['city']}, {item['state_id']}")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('zen-studio/us-zipcode-to-city-name-state-lat-lng').call({
    zipcodes: ['90210', '10001', '60601']
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.zip}: ${item.city}, ${item.state_id}`);
});

Use Cases

• Data Enrichment: Add location data to customer records
• Address Validation: Verify ZIP codes exist and get city/state
• Geographic Analysis: Get coordinates for mapping
• Shipping/Logistics: Determine regions and timezones

Going global?

Looking for postal code data in other countries? Check out our other actors:

• /zen-studio/norwegian-postalcode-to-city-name - Norwegian postal codes (4-digit)
• /zen-studio/indian-pincode-postalcode-zip-code-to-city-state - Indian PIN codes (6-digit)

Notes

• ZIP codes must be provided as strings (e.g., "02134" not 2134)
• Invalid or non-existent ZIP codes will not appear in results
• Results are returned in no particular order
• Large requests are automatically chunked (100 ZIP codes per batch) and processed in parallel (up to 4 concurrent requests)