API Documentation

Introduction

The Infomance API provides programmatic access to European municipal data. With a single integration, you can access demographic, economic, and infrastructure indicators for over 98,000 municipalities across 34 EU countries.

Key features:

• RESTful API with JSON responses
• TypeScript and Python SDKs
• 40+ indicators per municipality
• Quality scores in every response

Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header of every request.

Authorization: Bearer YOUR_API_KEY

Get your API key by creating an account at infomance.io. Keep your API key secure and never expose it in client-side code.

Endpoints

The API provides the following endpoints for accessing municipal data.

Code Examples

Here are examples of how to make requests to the API using different languages and tools.

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

Response Format

All responses are returned in JSON format. Here's an example response from the municipality endpoint.

{
  "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"
  }
}

Rate Limits

API requests are rate limited based on your plan. When you exceed the limit, you'll receive a 429 response.

Errors

The API uses standard HTTP status codes to indicate success or failure of requests.

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