# brasilapi/brasilapi

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/brasilapi-brasilapi).**

10,750 stars · 735 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/BrasilAPI/BrasilAPI
- Homepage: https://brasilapi.com.br
- awesome-repositories: https://awesome-repositories.com/repository/brasilapi-brasilapi.md

## Description

BrasilAPI is a REST API gateway that aggregates and exposes official Brazilian public data from fragmented government sources. It functions as a multi-provider data aggregator that normalizes heterogeneous information into a standardized JSON schema for consistent delivery.

The system utilizes a multi-provider fallback pipeline to ensure reliable data resolution, querying several external APIs in sequence if a primary provider fails. It also incorporates a caching proxy gateway to reduce latency and avoid redundant requests for frequently accessed public data.

The platform covers a broad range of public data domains, including corporate registrations via company tax IDs, financial market data and banking directories, postal code and geolocation resolution, and meteorological forecasts. It also provides access to national holiday calendars, health terminology, product classification codes, and internet domain registration status.

## Tags

### Web Development

- [Brazilian Public](https://awesome-repositories.com/f/web-development/data-aggregators/brazilian-public.md) — Aggregates official Brazilian government data from fragmented sources into a single, unified API gateway.
- [Brazilian Public Data APIs](https://awesome-repositories.com/f/web-development/public-api-exposure/brazilian-public-data-apis.md) — Provides a unified REST API gateway to expose official Brazilian public data from various government sources.
- [Schema Normalizations](https://awesome-repositories.com/f/web-development/external-api-integrations/schema-normalizations.md) — Normalizes heterogeneous data from fragmented government sources into a consistent, unified JSON schema.
- [Brokerage Firm Directories](https://awesome-repositories.com/f/web-development/public-api-exposure/brazilian-public-data-apis/brokerage-firm-directories.md) — Provides a directory of active brokerage firms registered with the Brazilian securities commission. ([source](https://brasilapi.com.br/docs))
- [Municipal Directories](https://awesome-repositories.com/f/web-development/public-api-exposure/brazilian-public-data-apis/municipal-directories.md) — Retrieves all municipalities within a specific state along with their identification codes. ([source](https://brasilapi.com.br/docs))
- [Payment System Participant Directories](https://awesome-repositories.com/f/web-development/public-api-exposure/brazilian-public-data-apis/payment-system-participant-directories.md) — Retrieves information on all participants in the Brazilian PIX instant payment system. ([source](https://brasilapi.com.br/docs))

### Artificial Intelligence & ML

- [Public Data Gateways](https://awesome-repositories.com/f/artificial-intelligence-ml/model-provider-integrations/public-data-gateways.md) — Functions as a gateway that aggregates various external services into a normalized schema with caching and fallback logic.

### Part of an Awesome List

- [Schema Normalizers](https://awesome-repositories.com/f/awesome-lists/data/json-processing/json-transformation/schema-normalizers.md) — Transforms fragmented data from multiple public providers into a standardized JSON schema for consistent delivery.

### Business & Productivity Software

- [Brazilian Weather Forecasts](https://awesome-repositories.com/f/business-productivity-software/weather-forecasting-applications/brazilian-weather-forecasts.md) — Provides current meteorological conditions and multi-day forecasts for Brazilian cities and airports.
- [Currency Rate Calculators](https://awesome-repositories.com/f/business-productivity-software/currency-exchange/currency-rate-calculators.md) — Implements a utility to retrieve exchange rates for foreign currencies against the local currency for specific dates. ([source](https://brasilapi.com.br/docs))
- [Vehicle Market Prices](https://awesome-repositories.com/f/business-productivity-software/pricing-structures/pricing-data-retrieval/real-time-market-prices/vehicle-market-prices.md) — Retrieves used vehicle market prices based on the official Brazilian FIPE pricing table. ([source](https://brasilapi.com.br/docs))
- [Ocean Forecasts](https://awesome-repositories.com/f/business-productivity-software/weather-forecasting-applications/ocean-forecasts.md) — Retrieves multi-day oceanic condition forecasts for Brazilian coastal cities. ([source](https://brasilapi.com.br/docs))
- [Weather Location Directories](https://awesome-repositories.com/f/business-productivity-software/weather-forecasting-applications/weather-location-directories.md) — Provides a directory of Brazilian cities and their associated codes for weather queries. ([source](https://brasilapi.com.br/docs))
- [Airport Weather Reports](https://awesome-repositories.com/f/business-productivity-software/weather-widgets/current-weather-displays/airport-weather-reports.md) — Returns current meteorological conditions for airports using ICAO codes. ([source](https://brasilapi.com.br/docs))

### Data & Databases

- [Brazilian Company Registries](https://awesome-repositories.com/f/data-databases/brazilian-company-registries.md) — Retrieves corporate registration data, partner information, and tax status using Brazilian CNPJ numbers.
- [Brazilian Financial Market Data](https://awesome-repositories.com/f/data-databases/brazilian-financial-market-data.md) — Provides access to stock tickers, investment funds, and brokerage firm details registered with Brazilian regulators.
- [Brazilian Postal Code Resolvers](https://awesome-repositories.com/f/data-databases/brazilian-postal-code-resolvers.md) — Converts CEP postal codes into physical addresses and coordinates using a multi-provider fallback system.
- [Postal Geolocation](https://awesome-repositories.com/f/data-databases/brazilian-postal-code-resolvers/postal-geolocation.md) — Retrieves geographic coordinates and address details based on a Brazilian postal code. ([source](https://brasilapi.com.br/docs))
- [Multi-Source Data Aggregation](https://awesome-repositories.com/f/data-databases/data-source-connectivity-tools/multi-source-data-aggregation.md) — Retrieves and aggregates information from diverse external government APIs to provide a unified data view.
- [Administrative Geography Registries](https://awesome-repositories.com/f/data-databases/administrative-geography-registries.md) — Provides a directory of all Brazilian states using official IBGE database information. ([source](https://brasilapi.com.br/docs))
- [Brazilian Stock Tickers](https://awesome-repositories.com/f/data-databases/asset-management/asset-library-identifiers/ticker-symbol-standardizations/ticker-data-fetchers/brazilian-stock-tickers.md) — Provides a complete registry of stock tickers for companies and investment funds listed on the B3 exchange. ([source](https://brasilapi.com.br/docs))
- [Brazilian National Registries](https://awesome-repositories.com/f/data-databases/brazilian-national-registries.md) — Retrieves the complete list of national holidays for a given year from official registries. ([source](https://brasilapi.com.br/docs))
- [Economic Index Registries](https://awesome-repositories.com/f/data-databases/economic-index-registries.md) — Provides a listing of current official interest rates and national economic indexes. ([source](https://brasilapi.com.br/docs))
- [Book Metadata Indexes](https://awesome-repositories.com/f/data-databases/full-text-search-engines/metadata-indexing/structured-metadata-indexes/book-metadata-indexes.md) — Provides a lookup utility to retrieve detailed book metadata using an ISBN. ([source](https://brasilapi.com.br/docs))
- [Fallback Pipelines](https://awesome-repositories.com/f/data-databases/geolocation-services/fallback-pipelines.md) — Resolves geographic coordinates by chaining multiple geocoding services with automatic fallback logic.
- [Service Call Caches](https://awesome-repositories.com/f/data-databases/in-memory-caches/request-scoped-caching/service-call-caches.md) — Provides a caching proxy that stores the output of remote service calls to avoid redundant network requests.
- [Fund Composition Data](https://awesome-repositories.com/f/data-databases/information-retrieval/fund-composition-data.md) — Provides descriptive registration information and details for specific investment funds. ([source](https://brasilapi.com.br/docs))
- [Investment Fund Directories](https://awesome-repositories.com/f/data-databases/information-retrieval/investment-fund-directories.md) — Provides a paginated directory of all investment funds registered with the securities commission. ([source](https://brasilapi.com.br/docs))
- [Interest Rate Registries](https://awesome-repositories.com/f/data-databases/interest-rate-registries.md) — Retrieves detailed information for specific official interest rates by name or abbreviation. ([source](https://brasilapi.com.br/docs))
- [Response Caching](https://awesome-repositories.com/f/data-databases/key-value-stores/response-caching.md) — Implements a caching layer to store responses from external APIs, reducing latency and upstream load.

### Software Engineering & Architecture

- [Provider Fallback Sequencing](https://awesome-repositories.com/f/software-engineering-architecture/provider-fallback-sequencing.md) — Implements logic to query multiple external API providers in a specific sequence with automatic fallback upon failure.
- [Resource-Oriented Design](https://awesome-repositories.com/f/software-engineering-architecture/resource-oriented-design.md) — Organizes API endpoints around public data entities using standard HTTP methods and domain-driven patterns.
- [Stateless Architectures](https://awesome-repositories.com/f/software-engineering-architecture/stateless-architectures.md) — Processes every request independently without server-side session state to enable horizontal scaling.

### Networking & Communication

- [Cache Proxies](https://awesome-repositories.com/f/networking-communication/cache-proxies.md) — Employs a caching proxy to intercept and store external API responses for improved performance.
- [Domain Registration Checkers](https://awesome-repositories.com/f/networking-communication/domain-registration-checkers.md) — Evaluates the registration status of specific .br domain names. ([source](https://brasilapi.com.br/docs))

### Security & Cryptography

- [Banking Institution Directories](https://awesome-repositories.com/f/security-cryptography/integration-detail-retrieval/banking-data/banking-institution-directories.md) — Ships a complete directory of all operating banks in Brazil with their respective codes. ([source](https://brasilapi.com.br/docs))
- [Brazilian Bank Lookups](https://awesome-repositories.com/f/security-cryptography/integration-detail-retrieval/banking-data/brazilian-bank-lookups.md) — Allows retrieval of detailed information for specific Brazilian banks using their identification codes. ([source](https://brasilapi.com.br/docs))