Documentacao da API

Introducao

A API Infomance fornece acesso programatico a dados municipais europeus. Com uma unica integracao, voce pode acessar indicadores demograficos, economicos e de infraestrutura de mais de 98.000 municipios em 34 paises da UE.

Principais recursos:

• API RESTful com respostas em JSON
• SDKs para TypeScript e Python
• 40+ indicadores por municipio
• Quality scores em cada resposta

Início Rápido

Obtenha sua primeira resposta em menos de 2 minutos.

Passo 1 — Crie sua conta

Cadastre-se gratuitamente — sem cartão de crédito. Você recebe 1.000 requisições/mês gratuitas para explorar a API.

Passo 2 — Obtenha sua API key

Após o cadastro, acesse seu dashboard e crie uma API key. Ela começa com inf_.

Passo 3 — Faça sua primeira chamada

Sem necessidade de autenticação — teste primeiro este endpoint público:

# List all 34 EU countries (no API key required)
curl https://api.infomance.com.br/api/v1/eu/countries

Depois use sua API key para dados detalhados:

# Get Berlin municipality data
curl https://api.infomance.com.br/api/v1/eu/lau/DE_11000000 \
  -H "X-API-Key: YOUR_API_KEY"

# List Portuguese municipalities
curl "https://api.infomance.com.br/api/v1/eu/lau?country=PT&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Passo 4 — Use o SDK

import { InfomanceClient } from 'infomance'

const client = new InfomanceClient({ apiKey: 'YOUR_API_KEY' })
const berlin = await client.getEULAUById('DE_11000000')
console.log(berlin.name, berlin.population) // Berlin, 3644826

Pronto. Você está preparado para construir.

Autenticacao

Todas as requisicoes da API requerem autenticacao usando um Bearer token. Inclua sua API key no header Authorization de cada requisicao.

# Option 1: Bearer token
Authorization: Bearer YOUR_API_KEY

# Option 2: X-API-Key header
X-API-Key: YOUR_API_KEY

Obtenha sua API key criando uma conta em infomance.io. Mantenha sua API key segura e nunca a exponha em codigo client-side.

Endpoints

A API fornece os seguintes endpoints para acessar dados municipais.

Brasil

Europa

Exemplos de Codigo

Aqui estao exemplos de como fazer requisicoes para a API usando diferentes linguagens e ferramentas.

curl -X GET "https://api.infomance.com.br/api/v1/cities/3550308/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Formato de Resposta

Todas as respostas sao retornadas em formato JSON. Aqui esta um exemplo de resposta do endpoint de municipio.

{
  "ibge_code": "3550308",
  "name": "São Paulo",
  "state": "SP",
  "population": 12325232,
  "area_km2": 1521.11,
  "indicators": {
    "demographics": {
      "population_density": 8105.2,
      "median_age": 35.7
    },
    "economy": {
      "gdp_per_capita": 65892.0,
      "employment_rate": 58.2
    }
  },
  "quality": {
    "completeness": 0.96,
    "last_updated": "2026-03-15",
    "source": "IBGE"
  }
}

Limites de Requisicoes

As requisicoes da API sao limitadas de acordo com seu plano. Quando voce exceder o limite, recebera uma resposta 429.

Erros

A API usa codigos de status HTTP padrao para indicar sucesso ou falha das requisicoes.

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Please wait before retrying.",
    "retry_after": 60
  }
}