Skip to content

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 to look up, such as 90210 or 10115.

More options

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

1 credit per run

Example results

Country
United States
Postal Code
90210
Places
Places
Place NameStateLatitudePage URLLongitudeState Abbreviation
Beverly Hills
California
34.0901
-118.4065
CA
Example data · Run in Studio for fresh results.

Choose an action

About Zippopotam.us

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 by Fous from zippopotam.us and checked automatically; it last passed a check on Sep 29, 2026. Fous is not affiliated with Zippopotam.us.

Actions

Get postal code

1 credit per run

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

FieldTypeRequiredDescription
CountrycountryTextOptionalCountry name or two-letter country code, such as Germany or DE. Defaults to United States.Example: Germany
Postal Codepostal_codeTextRequiredPostal code to look up, such as 90210 or 10115.Example: 90210

What you get

FieldTypeDescription
PlacesplacesListPlaces using this postal code.
Stateplaces[].stateTextState or region name.Example: California
Latitudeplaces[].latitudeNumberLatitude in decimal degrees.Example: 34.0901
Page URLplaces[].page_urlTextLink to this postal code on Zippopotam.us.Example: https://api.zippopotam.us/us/90210
Longitudeplaces[].longitudeNumberLongitude in decimal degrees.Example: -118.4065
Place Nameplaces[].place_nameTextPlace name.Example: Beverly Hills
State Abbreviationplaces[].state_abbreviationTextState or region abbreviation.Example: CA
CountrycountryTextCountry name.Example: United States
Postal Codepostal_codeTextPostal 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 per run

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

FieldTypeRequiredDescription
TowntownTextRequiredTown to search, for example Beverly Hills.Example: Beverly Hills
StatestateTextRequiredState or region name or abbreviation, for example California or CA.Example: California
CountrycountryTextOptionalCountry name or two-letter country code, for example United States or US. Defaults to United States.Example: US

What you get

FieldTypeDescription
Postal Codespostal_codesListPostal codes in ascending order; empty if none match.
Townpostal_codes[].townTextTown searched.Example: Beverly Hills
Statepostal_codes[].stateTextState or region name.Example: California
Countrypostal_codes[].countryTextCountry name.Example: United States
Latitudepostal_codes[].latitudeNumberLatitude, if available.Example: 33.7866
Longitudepostal_codes[].longitudeNumberLongitude, if available.Example: -118.2987
Page Linkpostal_codes[].page_linkTextLink to the postal code details.Example: https://zippopotam.us/us/90209
Place Namepostal_codes[].place_nameTextPlace name associated with the postal code.Example: Beverly Hills
Postal Codepostal_codes[].postal_codeTextPostal 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

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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

Is Fous affiliated with Zippopotam.us?

No. Fous is not affiliated with Zippopotam.us. This workflow reads the public zippopotam.us website and returns its data.

How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

What places use a postal code?

Get postal code returns places, regions, and coordinates for the postal code you provide.

Which postal codes match a town and region?

Search postal codes returns matching postal codes, place names, and coordinates for the town and state or region you provide.

All Maps workflowsBrowse all workflows