Skip to content

Zippopotam.us

Postal codes and places and coordinates

Back to tools

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 completed run

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

Example results

Places for 90210

United States

Choose an action

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

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

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

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.

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 toolsBrowse all tools