Postal Codes
Look up postal codes in 11 countries: place name, state, coordinates, nearby codes and distance between codes.
base https://postal-codes2.p.rapidapi.com/postal/v1- endpoints
- 5
- free plan, paid from
- $15/mo
- data
- Self-contained
Turn a postal code into a place, state and approximate coordinates, search codes by place name, find codes within a radius and measure the distance between two codes.
// Where is ZIP code 94103?
curl "https://postal-codes2.p.rapidapi.com/postal/v1/US/94103" \
-H "X-RapidAPI-Key: $RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: postal-codes2.p.rapidapi.com"{
"postal_code": "94103",
"country": "US",
"places": ["San Francisco"],
"state": "California",
"state_code": "CA",
"county": "City and County of San Francisco",
"latitude": 37.7725,
"longitude": -122.4147,
"attribution": "Postal code data from GeoNames (geonames.org), CC BY 4.0"
}Endpoints
List covered countries
Look up a postal code
Returns the place names, state or region, county and approximate centre coordinates for a postal code.
countrypathrequiredcodepathrequired
Find postal codes within a radius
countrypathrequiredcodepathrequiredradius_kmquerylimitquery
Distance between two postal codes
Straight-line distance between the approximate centres of two postal codes.
from_countryqueryrequiredfrom_codequeryrequiredto_countryqueryrequiredto_codequeryrequired
Find postal codes by place name
countrypathrequiredqqueryrequiredstate_codequerylimitquery
Data and limits
source
Bundled GeoNames postal data (CC BY 4.0). Responses include the GeoNames attribution.
Answers from bundled data or local computation. No upstream call.
limits
- Covers 11 countries: US, GB, CA, DE, FR, ES, IT, NL, AU, MX and IN. GB, CA and NL are partial codes only.
- Coordinates are approximate centres.
Plans
Monthly, in US dollars. Each plan stops at its quota, with no overage charges. Subscribe and pay on RapidAPI.
| plan | price | calls / month | per 1k calls | |
|---|---|---|---|---|
| Basic | Free | 100 | — | start free on RapidAPI ↗ |
| Pro | $15 | 10,000 | $1.50 | subscribe on RapidAPI ↗ |
| Ultra | $29 | 100,000 | $0.29 | subscribe on RapidAPI ↗ |
| Mega | $109 | 500,000 | $0.22 | subscribe on RapidAPI ↗ |