Listar Países disponíveis
Endpoints para acessar dados históricos de Índices de Inflação.
Permite consultar a inflação de diferentes países ao longo do tempo e listar os países com dados disponíveis.
Listar Países com Dados de Inflação Disponíveis
Obtenha a lista completa de todos os países para os quais a API Brapi possui dados de inflação disponíveis para consulta no endpoint /api/v2/inflation
.
Funcionalidade:
- Retorna um array
countries
com os nomes dos países (em minúsculas). - Pode ser filtrado usando o parâmetro
search
.
Autenticação:
Requer token de autenticação via token
(query) ou Authorization
(header).
Exemplo de Requisição:
Listar todos os países com dados de inflação:
curl -X GET "https://brapi.dev/api/v2/inflation/available?token=SEU_TOKEN"
Buscar países cujo nome contenha 'arg':
curl -X GET "https://brapi.dev/api/v2/inflation/available?search=arg&token=SEU_TOKEN"
Resposta:
A resposta é um objeto JSON com a chave countries
, contendo um array de strings com os nomes dos países (ex: ["brazil", "argentina", "usa"]
).
Autenticação via header HTTP Authorization
. Use o formato Authorization: Bearer SEU_TOKEN
. Obtenha seu token.
In: header
Query Parameters
Opcional. Termo para filtrar a lista pelo nome do país (correspondência parcial, case-insensitive). Se omitido, retorna todos os países.
Obrigatório caso não esteja adicionado como header "Authorization". Seu token de autenticação pessoal da API Brapi.
Formas de Envio:
- Query Parameter: Adicione
?token=SEU_TOKEN
ao final da URL. - HTTP Header: Inclua o header
Authorization: Bearer SEU_TOKEN
na sua requisição.
Ambos os métodos são aceitos, mas pelo menos um deles deve ser utilizado. Obtenha seu token em brapi.dev/dashboard.
Response Body
curl -X GET "https://brapi.dev/api/v2/inflation/available?search=string&token=string"
{
"countries": [
"brazil"
]
}
{
"error": true,
"message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}
{
"message": "Country not found"
}