ViaCep

Geocoding API · No Authentication Required · Works in BR

Overview

Brazilian postal code lookup

Notes: Free Brazilian postcode lookup API.

TL;DR

What it does: ViaCep: Brazilian postal code lookup.

Quick start: https://viacep.com.br/ws/01310994/json/

No API key needed!

Try It Now

Call this URL to see what you get back:

https://viacep.com.br/ws/01310994/json/
Try This URL Now →

FAQ

Do I need an API key?
No! This API is completely free to use with no authentication required.
Is there a rate limit?
Most free APIs have generous limits. Check documentation for specifics.
Can I use this in a commercial project?
Yes, these APIs are free for both personal and commercial use. Check the documentation for any specific restrictions.
How do I get started?
Copy the example URL above and paste it into your browser or code. The response is in JSON format which you can parse in any programming language.

Code Examples

JavaScript Example

fetch('https://viacep.com.br/ws/01310994/json/')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Python Example

import requests

url = 'https://viacep.com.br/ws/01310994/json/'
response = requests.get(url)
data = response.json()
print(data)

API Details

API URL
https://viacep.com.br
Documentation
https://viacep.com.br
Category
Geocoding
Authentication
Not Required
Geographic Coverage
BR

What You Can Build