json: Search CEPs by address

API: com.br:viacep-api
Endpoint: /{uf}/{cidade}/{logradouro}/json
Response format: application/json
Auth: none
Method: GET
Last Status: 200
Latency: 965ms

Description

Returns a list of postal codes matching the given state (UF), city, and street name. Returns up to 50 results ordered by proximity to the street name.

Parameters (3)

cidade (string, path, required)

City name (minimum 3 characters)

Constraints: {'minLength': 3}

logradouro (string, path, required)

Street name or address fragment (minimum 3 characters)

Constraints: {'minLength': 3}

uf (string, path, required)

Brazilian state abbreviation (2 letters)

Constraints: {'enum': ['AC', 'AL', 'AP', 'AM', 'BA', 'CE', 'DF', 'ES', 'GO', 'MA', 'MT', 'MS', 'MG', 'PA', 'PB', 'PR', 'PE', 'PI', 'RJ', 'RN', 'RS', 'RO', 'RR', 'SC', 'SP', 'SE', 'TO']}

Examples (1)

Search CEPs by address openapi-spec 
curl 'https://viacep.com.br/ws/SP/Sao Paulo/Paulista/json'
import requests

resp = requests.get("https://viacep.com.br/ws/SP/Sao Paulo/Paulista/json")
data = resp.json()
import zingu_apis

api = zingu_apis.api("com")
result = api.fetch("{uf}/{cidade}/{logradouro}/json")

for item in result:
    print(item)
const resp = await fetch("https://viacep.com.br/ws/SP/Sao Paulo/Paulista/json");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 01:17:01.408832 200 965ms
2026-04-15 02:35:38.351586 200 752ms
2026-04-14 03:49:30.711948 200 413ms
2026-04-12 14:15:48.254003 200 536ms
2026-04-10 06:41:17.402080 200 894ms
2026-04-09 01:50:03.139622 200 1004ms
2026-04-08 00:36:07.197889 200 443ms
2026-04-07 00:18:07.804196 200 898ms
2026-04-06 06:21:50.864344 200 982ms
2026-04-05 02:46:09.684364 200 929ms