Postal Code Lookup

hipersoft/postal-code-lookup

Look up postal/ZIP codes in bulk across many countries: city/place name, state or region, and latitude/longitude. Just paste codes and pick a country (or prefix each like 'DE:10115'). Great for address forms, shipping, geo enrichment and analytics. One row per code as JSON, CSV or Excel.

Run this scraper →See the API call

Total users

Monthly users

Total runs

Per lookup

$0.0002

Last rebuilt

Oct 28, 2026

Overview

Turn postal and ZIP codes into locations in bulk with the Postal Code Lookup. Paste a list of codes, pick a country (or prefix each code with its own), and export the city/place name, state or region, and latitude/longitude for each — one clean row per code as JSON, CSV or Excel.

Built for address forms and validation, shipping and logistics, geo enrichment, store locators and analytics, it covers many countries and resolves codes to real places with coordinates.

What it does

📮 ZIP/postal → place — city or place name and state/region for each code.
📍 Coordinates — latitude and longitude for mapping and distance calculations.
🌍 Many countries — US, GB, DE, CA, FR, AU and more; set a default or prefix per code.
🔀 Multiple places — codes that map to several places return them all.
⚡ Bulk — look up long lists of codes in one run.
📤 Export anywhere — JSON, CSV or Excel, or straight into a form, CRM or map.

Example output

{
  "countryCode": "US",
  "postalCode": "10001",
  "placeName": "New York City",
  "state": "New York",
  "latitude": 40.7484,
  "longitude": -73.9967,
  "placesCount": 1
}

How to use it

Paste a list of postal/ZIP codes.
Set the default country (or prefix codes like DE:10115).
Run, and download the results as JSON, CSV or Excel.

Input fields

Field	Description
Postal / ZIP codes	Codes to look up; prefix like `GB:SW1A` to override country.
Default country	Two-letter code for un-prefixed codes (US, GB, DE…).
Max lookups	Maximum codes to process (0 = no limit).

Output fields

country, countryCode, postalCode, found, placeName, state, stateCode, latitude, longitude, placesCount, places.

Popular use cases

Address forms — auto-fill city/state from a ZIP code.
Shipping & logistics — map codes to places and coordinates.
Geo enrichment — add city, region and coordinates to a code list.
Store locators — resolve customer codes to lat/long for nearest-store logic.
Analytics — group and map data by region.

FAQ

Do I need an account or key? No. Paste your codes and run.

Which countries are supported? A broad set including the US, UK, Germany, Canada, France, Australia and many more — set a default country or prefix each code.

What if a code maps to several places? All matching places are returned, with the first used for the flat fields.

Can I export to Excel or Google Sheets? Yes — results download as JSON, CSV or Excel and integrate with forms, CRMs and maps.

Bulk postal-code to city, region and coordinates across many countries — clean and export-ready for address forms, shipping and geo enrichment.

Input

Field	Type	Description
`postalCodes` Postal / ZIP codes	array	Codes to look up — e.g. '10001', '90210'. Use the country below, or prefix a code with its country like 'DE:10115' or 'GB SW1A' to override per code.
`country` Default country	string	Two-letter country code for codes without a prefix — e.g. 'US', 'GB', 'DE', 'CA', 'FR', 'AU'. Default: `"US"`
`maxItems` Max lookups	integer	Maximum number of codes to look up (0 = no limit). Default: `0`

API

curl -X POST "https://api.apify.com/v2/acts/hipersoft~postal-code-lookup/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "postalCodes": [
    "10001",
    "90210"
  ]
}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("hipersoft/postal-code-lookup").call(run_input={
    "postalCodes": [
        "10001",
        "90210"
    ]
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('hipersoft/postal-code-lookup').call({
  "postalCodes": [
    "10001",
    "90210"
  ]
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Pricing

Event	Price	Paid plans from
Lookup Charged for each postal code looked up.	$0.0002	$0.0001

You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.

Related scrapers

Bulk Image Downloader

Download thousands of images from a list of URLs and store each in the key-value store with a public link. Returns content type, size, dimensions and SHA-256 per image. Bulk-ready. Great for datasets, backups and media pipelines.

8,102 runs · 103 users · $0.056 / url processed

Text to Speech

Convert any text to natural-sounding speech as an MP3 download. 300+ premium neural voices across 70+ languages, adjustable rate, pitch and volume. Great for voiceovers, videos, accessibility and audio content. No setup.

278 runs · 22 users · $0.01 / audio generated

Google Maps Email Extractor

Search Google Maps for businesses, then crawl each business website to extract emails, social profiles and extra phone numbers. Turns any Maps search into a ready lead list. No setup.

159 runs · 8 users · $0.006 / business lead scraped

Website Screenshot

Capture full-page or viewport screenshots of any URL as PNG or JPEG, at any device size. For monitoring, previews, thumbnails and automation workflows.

156 runs · 3 users · $0.004 / screenshot captured

Bulk URL Status Checker

Check thousands of URLs over plain HTTP: status codes, broken links (404/410/5xx), full redirect chains, response time, content type, page title and SSL certificate expiry.

154 runs · 13 users · $0.002 / url checked

Google Search Scraper

Scrape Google Search results (organic listings) for any query: title, URL, displayed URL, snippet and position. Multi-query, per-country/language, pagination. Uses Google SERP proxy — reliable, no captcha, no setup.

121 runs · 8 users · $0.001 / result scraped

Need a source that isn't here?

Send the site and the fields. We build it and you get it first.

Request a build