BrasilAPI/cep-promise

Health v2 · maintenance only

Adoption not part of the score

2968 stars · 317 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A JavaScript library for looking up Brazilian postal codes (CEP) that queries multiple providers (Correios, ViaCEP, WideNet) concurrently and returns the fastest response. It works in both Node.js and the browser and exposes a simple Promise-based API.

Use cases

• look up a Brazilian address from a CEP postal code
• validate and normalize user-entered CEP numbers in a form
• get city, state, street, and neighborhood from a zipcode
• handle CEPs stored as integers with missing leading zeros
• add resilient zipcode lookup with multiple provider fallbacks
• fetch address data in a Node.js backend or browser app

When to choose

• you need Brazilian CEP lookup with high availability via multiple providers
• you want the fastest response by querying services concurrently
• you need a library that works in both Node.js and the browser
• your CEP data may be stored as integers without leading zeros

When to avoid

• you need postal code lookup for countries other than Brazil
• you need offline zipcode data without calling external services
• you require guaranteed rate limits or SLAs from providers
• you need a non-Promise (callback or async-iterator) API

Facets

library · maturity stable

http-client search-engine web-development apis developer-tools browser cep zipcode brazil correios viacep promise-based fallback-providers nodejs javascript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="BrasilAPI/cep-promise")