GeoInfo API
Começar

REST · JSON · Bearer token

Países, estados e cidades numa API só

Integre formulários, checkout, logística e analytics com dados geográficos consistentes. Você paga pelo volume de requisições — escale quando precisar.

Criar conta grátis Ver endpoints

  • Respostas rápidas

    CDN + cache onde aplicável

  • Autenticação

    Token por usuário

  • Paginação

    Listas grandes sob controle

  • JSON limpo

    Fácil de mapear no app

Como funciona

Três passos para sair do CSV improvisado e ir para produção com dados confiáveis.

  1. 1

    Crie sua conta

    Gere credenciais e obtenha o token de API no painel.

  2. 2

    Escolha o plano

    Limite mensal de requisições alinhado ao seu tráfego — upgrade quando crescer.

  3. 3

    Consuma a API

    Use os endpoints versionados com cabeçalho Authorization: Bearer.

Endpoints principais

Base da API: https://www.geoinfo.lucasgiovanni.com.br/api/v1 · todas as rotas abaixo exigem autenticação (Sanctum).

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/countries

Lista países (paginada)

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/countries/{id}/id

Detalhe do país por ID

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/countries/{iso2}/iso2

Detalhe do país por ISO2

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/countries/{state}/state

Estados do país

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/states

Lista estados (paginada)

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/states/{id}/id

Detalhe do estado por ID

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/states/{iso2}/iso2

Detalhe do estado por ISO2

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/states/{id}/cities

Cidades do estado

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/cities

Lista cidades (paginada)

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/cities/{id}/id

Detalhe da cidade por ID

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/regions

Lista regiões

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/regions/{id}/id

Detalhe da região por ID

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/subregions

Lista sub-regiões

GET https://www.geoinfo.lucasgiovanni.com.br/api/v1/subregions/{id}/id

Detalhe da sub-região por ID

Exemplo de requisição

curl -s -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json" \
  "https://www.geoinfo.lucasgiovanni.com.br/api/v1/countries"

Preços por requisições

Valores ilustrativos — ajuste no painel/admin quando definir a tabela comercial. O importante é comunicar claramente o limite mensal e o que acontece ao ultrapassar.

Grátis

R$ 0 / mês

até 3.000 req/mês

  • Acesso a países, estados e cidades
  • Ideal para protótipos
  • Suporte comunitário
Começar
Mais popular

Produção

R$ 49 / mês

até 30.000 req/mês

  • Acesso a países, estados e cidades
  • Prioridade em rate limit
  • Logs básicos de uso
  • E-mail de suporte
Assinar

Profissional

R$ 99 / mês

até 100.000 req/mês

  • Acesso a países, estados e cidades
  • Prioridade em rate limit
  • Logs completos de uso
  • Canal direto com o time
Assinar

Pronto para integrar?

Crie a conta, gere o token e teste os endpoints no painel. Menos manutenção de planilhas, mais tempo para o seu produto.

Registrar agora Já tenho conta