Zippopotam.us

Postal codes and places and coordinates

Zippopotam.us returns places, regions and coordinates for postal codes in supported countries, and finds postal codes, places and coordinates by town and region.

Get postal code

Get places, regions, and coordinates for a postal code in a supported country. Some postal codes may list more than one place.

Your information

Postal Code

Postal code to look up, such as 90210 or 10115.

More options

CountryOptional

Country name or two-letter country code, such as Germany or DE. Defaults to United States.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Places for 90210

United States

About the Zippopotam.us tool

Zippopotam.us looks up places, regions, and coordinates for a postal code; provide a postal code and optionally a country.

Search postal codes finds postal codes, place names, and coordinates for a town and state or region; provide both and optionally a country.

Built from zippopotam.us. Last checked Sep 29, 2026.

Actions

Get postal code

1 credit

Get places, regions, and coordinates for a postal code in a supported country. Some postal codes may list more than one place.

What you provide

Field	Type	Required	Description
Country`country`	Text	Optional	Country name or two-letter country code, such as Germany or DE. Defaults to United States.Example: Germany
Postal Code`postal_code`	Text	Required	Postal code to look up, such as 90210 or 10115.Example: 90210

What you get

Field	Type	Description
Places`places`	List	Places using this postal code.
State`places[].state`	Text	State or region name.Example: California
Latitude`places[].latitude`	Number	Latitude in decimal degrees.Example: 34.0901
Page URL`places[].page_url`	Text	Link to this postal code on Zippopotam.us.Example: https://api.zippopotam.us/us/90210
Longitude`places[].longitude`	Number	Longitude in decimal degrees.Example: -118.4065
Place Name`places[].place_name`	Text	Place name.Example: Beverly Hills
State Abbreviation`places[].state_abbreviation`	Text	State or region abbreviation.Example: CA
Country`country`	Text	Country name.Example: United States
Postal Code`postal_code`	Text	Postal code looked up.Example: 90210

Example result

For Postal Code: 90210

JSON

{
  "places": [
    {
      "state": "California",
      "latitude": 34.0901,
      "page_url": "https://api.zippopotam.us/us/90210",
      "longitude": -118.4065,
      "place_name": "Beverly Hills",
      "state_abbreviation": "CA"
    }
  ],
  "country": "United States",
  "postal_code": "90210"
}

Search postal codes

1 credit

Find postal codes, place names and coordinates for a town and state or region in a supported country. Some region names outside the mapped countries may require an abbreviation.

What you provide

Field	Type	Required	Description
Town`town`	Text	Required	Town to search, for example Beverly Hills.Example: Beverly Hills
State`state`	Text	Required	State or region name or abbreviation, for example California or CA.Example: California
Country`country`	Text	Optional	Country name or two-letter country code, for example United States or US. Defaults to United States.Example: US

What you get

Field	Type	Description
Postal Codes`postal_codes`	List	Postal codes in ascending order; empty if none match.
Town`postal_codes[].town`	Text	Town searched.Example: Beverly Hills
State`postal_codes[].state`	Text	State or region name.Example: California
Country`postal_codes[].country`	Text	Country name.Example: United States
Latitude`postal_codes[].latitude`	Number	Latitude, if available.Example: 33.7866
Longitude`postal_codes[].longitude`	Number	Longitude, if available.Example: -118.2987
Page Link`postal_codes[].page_link`	Text	Link to the postal code details.Example: https://zippopotam.us/us/90209
Place Name`postal_codes[].place_name`	Text	Place name associated with the postal code.Example: Beverly Hills
Postal Code`postal_codes[].postal_code`	Text	Postal code.Example: 90209

Example result

For Town: Beverly Hills, State: California

JSON

{
  "postal_codes": [
    {
      "town": "Beverly Hills",
      "state": "California",
      "country": "United States",
      "latitude": 33.7866,
      "longitude": -118.2987,
      "page_link": "https://zippopotam.us/us/90209",
      "place_name": "Beverly Hills",
      "postal_code": "90209"
    },
    {
      "town": "Beverly Hills",
      "state": "California",
      "country": "United States",
      "latitude": 34.0901,
      "longitude": -118.4065,
      "page_link": "https://zippopotam.us/us/90210",
      "place_name": "Beverly Hills",
      "postal_code": "90210"
    },
    {
      "town": "Beverly Hills",
      "state": "California",
      "country": "United States",
      "latitude": 34.0652,
      "longitude": -118.383,
      "page_link": "https://zippopotam.us/us/90211",
      "place_name": "Beverly Hills",
      "postal_code": "90211"
    }
  ]
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@zippopotam-us",
  "visibility": "public",
  "operation": "get_postal_code",
  "version": 1,
  "input": {
    "postal_code": "90210"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Find places associated with a postal code
Look up a postal code’s region and coordinates
Find postal codes for a town and state
Compare postal code locations across towns

Questions about Zippopotam.us

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this Zippopotam.us tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a Zippopotam.us account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from zippopotam.us when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.