GratuitoCORS abertoSem cadastroJSON

API de dados de bairros do RJ

Name: Onde Morar — Avaliação de bairros do Rio de Janeiro
Creator: Onde Morar
License: https://ondemorar.app/termos

O dado que alimenta o site, disponível para você consumir diretamente. Nota independente de ~160 bairros do estado do Rio de Janeiro, baseada em fontes públicas oficiais — segurança (ISP-RJ), valorização imobiliária (ITBI/Prefeitura do RJ), acesso a serviços (CNES, INEP, OSM).

A avaliação nunca está à venda. O dado é o mesmo usado por quem decide onde morar.

Endpoints — Tier Gratuito

Sem autenticação. Limite indicativo: 60 req/min por IP. Respostas em cache por 1h (CDN).

GET/api/v1/bairro/{bairro}

Avaliação de um único bairro. O {bairro} é o slug (ex.: copacabana, botafogo, icarai).

Parâmetros opcionais

municipio Filtrar por município quando o nome é ambíguo (ex.: rio-de-janeiro)

Exemplo

curl https://ondemorar.app/api/v1/bairro/copacabana
curl https://ondemorar.app/api/v1/bairro/centro?municipio=rio-de-janeiro

GET/api/v1/bairros

Lista de bairros avaliados, ordenados por nota. Útil para explorar o dataset completo ou filtrar por município.

Parâmetros opcionais

municipio	Filtrar por município (ex.: `rio-de-janeiro`, `niteroi`)
limite	Máx. de resultados (padrão 50, máx. 200)
ordenar	Critério: `nota` (padrão), `seguranca`, `valorizacao`, `servicos`

Exemplo

curl "https://ondemorar.app/api/v1/bairros?municipio=niteroi&ordenar=seguranca"
curl "https://ondemorar.app/api/v1/bairros?limite=10"

MCP/api/mcp

Servidor Model Context Protocol — para agentes de IA (Claude, GPT, etc.) consultarem bairros como ferramenta. JSON-RPC 2.0. Inclui busca por perfil, comparação e ranking.

Ver definição de ferramentas →

Exemplo de resposta

GET /api/v1/bairro/copacabana

{
  "bairro": "Copacabana",
  "municipio": "Rio de Janeiro",
  "slug": "copacabana",
  "slugMunicipio": "rio-de-janeiro",
  "url": "https://ondemorar.app/rio-de-janeiro/copacabana",
  "nota": {
    "geral": 4.1,
    "seguranca": 3.8,
    "valorizacao": 4.2,
    "servicos": 4.7,
    "investimentos": 3.7
  },
  "precoM2": 14200,
  "crescimentoPrecoM2_24m": 0.07,
  "populacao": 153000,
  "dataAtualizacao": "2026-07-25T13:18:35.308Z",
  "tier": "free",
  "_atribuicao": {
    "fonte": "Dados públicos oficiais — ISP-RJ, ITBI/Prefeitura RJ, CNES, INEP, OSM",
    "metodologia": "https://ondemorar.app/metodologia",
    "site": "https://ondemorar.app",
    "aviso": "Para uso comercial ou volume, consulte https://ondemorar.app/api-docs"
  }
}

GET /api/v1/bairros?municipio=rio-de-janeiro&limite=3

{
  "total": 3,
  "dataAtualizacao": "2026-07-25T13:18:35.308Z",
  "tier": "free",
  "bairros": [
    {
      "bairro": "Leblon",
      "municipio": "Rio de Janeiro",
      "slug": "leblon",
      "slugMunicipio": "rio-de-janeiro",
      "url": "https://ondemorar.app/rio-de-janeiro/leblon",
      "nota": { "geral": 4.6, "seguranca": 4.3, "valorizacao": 4.9, "servicos": 4.8 },
      "precoM2": 24500
    }
  ],
  "_atribuicao": { ... }
}

Uso em código

JavaScript / TypeScript (fetch)

const res = await fetch('https://ondemorar.app/api/v1/bairro/copacabana');
const data = await res.json();
console.log(data.nota.geral); // ex.: 4.1

Python (requests)

import requests
r = requests.get('https://ondemorar.app/api/v1/bairro/copacabana')
nota = r.json()['nota']['geral']  # ex.: 4.1

Em breve

API Premium — uso comercial e volume

O tier gratuito cobre exploração e prototipagem. A API Premium adiciona:

✓Chave de API dedicada com limite de volume maior
✓Histórico completo de valorização por bairro (série temporal ITBI)
✓Detalhamento de segurança por tipo de crime
✓Tendências e momentum de preço (mês a mês)
✓SLA e suporte por e-mail
✓Uso comercial liberado (relatórios, produtos pagos, dashboards)

Quero acesso antecipado à API Premium

Sem compromisso. Te avisamos no lançamento com prioridade.

Atribuição e termos de uso

O dado é público e derivado de fontes oficiais. O uso é livre para fins não comerciais com atribuição: cite “Onde Morar (ondemorar.app)” na fonte. Já o campo _atribuicao da resposta traz o texto de citação recomendado.

Para uso comercial (produto pago, revenda de dados, relatórios cobrados), entre em contato.

A nota nunca está à venda. A independência da avaliação é o diferencial do produto — e o que a torna confiável. Leia a metodologia →

Quem usa e para quê

Jornalistas de dados

Matérias sobre desigualdade, segurança e valorização imobiliária no RJ com dado verificável e independente.

Pesquisadores e acadêmicos

Dataset limpo de múltiplas dimensões por bairro — integra com modelos GIS, econométricos e de machine learning.

Desenvolvedores de apps

Enriqueça listagens de imóveis, filtros de busca ou dashboards com nota independente de bairro.

Imobiliárias e corretores

Dado neutro para embasar laudos, comparativos e apresentações a clientes. Veja o plano B2B.

← Voltar ao Onde Morar·Metodologia·Premium