mapswebDESCUBRA. CONECTE. CRESÇA.

API aberta do MapsWeb

Dados do guia comercial de Três Lagoas em JSON, prontos para apps e agentes de IA. Somente leitura, sem chave.

Endpoints

MétodoCaminhoO que retorna
GET/api/v1/index.jsonPonto de entrada: lista os endpoints e a data de geração.
GET/api/v1/empresas.jsonTodas as empresas (campos públicos da ficha).
GET/api/v1/empresas/{slug}.jsonUma empresa pelo slug da URL da ficha.
GET/api/v1/categorias.jsonCategorias e subcategorias com contagem real.
GET/api/v1/categorias/{slug}.jsonEmpresas de uma categoria.
GET/api/v1/bairros.jsonBairros com contagem de empresas e centro OSM quando confirmado.
GET/api/v1/mapa.jsonDados do mapa: pins verificados e grupos por bairro.
GET/api/v1/busca.jsonÍndice compacto usado pela busca do site.
GET/api/v1/noticias.jsonManchetes oficiais da Prefeitura (RSS), com link e data.
GET/api/openapi.jsonEspecificação OpenAPI 3.1.
GET/llms.txtResumo do site para modelos de linguagem.

Arquivos estáticos gerados no build a partir do cadastro do guia. CORS liberado (Access-Control-Allow-Origin: *), cache de 1 hora na CDN. Campos ausentes na ficha simplesmente não aparecem no JSON — nada é preenchido por estimativa.

Exemplo

curl https://mapsweb.com.br/api/v1/empresas/esgotec-limpa-fossa-e-desentupidora.json
{
  "slug": "esgotec-limpa-fossa-e-desentupidora",
  "nome": "ESGOTEC - LIMPA FOSSA E DESENTUPIDORA",
  "url": "https://mapsweb.com.br/ms/tres-lagoas/esgotec-limpa-fossa-e-desentupidora/",
  "api": "https://mapsweb.com.br/api/v1/empresas/esgotec-limpa-fossa-e-desentupidora.json",
  "categoria": {
    "slug": "servicos",
    "nome": "Serviços"
  },
  "subcategoria": {
    "slug": "limpa-fossa-e-desentupidora",
    "nome": "Limpa fossa e desentupidora"
  },
  "atividade_cnae": {
    "codigo": "3702900",
    "descricao": "Atividades relacionadas a esgoto, exceto a gestão de redes"
  },
  "endereco": {
    "logradouro": "Av. Prof. João Thomes, 1008",
    "complemento": null,
    "bairro": "Jardim Alvorada",
    "cep": "79610-180",
    "cidade": "Três Lagoas",
    "uf": "MS"
  },
  "bairro": "Jardim Alvorada",
  "telefone": "(67) 99219-7775",
  "whatsapp": "+5567992197775",
  "horario": [
    [
      "Domingo",
      "Fechado"
    ],
    [
      "Segunda-feira",
      "07:30–17:00"
    ],
    [
      "Terça-feira",
      "07:30–17:00"
    ],
    [
      "Quarta-feira",
      "07:30–17:00"
    ],
    [
      "Quinta-feira",
      "07:30–17:00"
    ],
    [
      "Sexta-feira",
      "07:30–17:00"
    ],
    [
      "Sábado",
      "07:30–11:00"
    ]
  ],
  "descricao": "A Esgotec é a desentupidora de referência em Três Lagoas, fornecendo serviços profissionais de desentupimento e limpa fossa em Três Lagoas. Contamos com uma equipe altamente qualificada e experiente para lidar com todos os tipos de entupimentos de esgoto, assegurando um serviço eficiente e de qualidade. Além disso, oferecemos limpeza de fossas com preços competitivos e um atendimento ágil. Se você está enfrentando problemas de entupimento ou precisa de serviços de limpeza de fossa, a Esgotec é a escolha certa em Três Lagoas. Entre em contato conosco para resolver seus problemas de forma eficaz e profissional.",
  "redes": {
    "instagram": "https://www.instagram.com/esgotectl/"
  },
  "fotos": [
    "https://mapsweb.com.br/img/empresas/esgotec-limpa-fossa-e-desentupidora-cover-609.webp"
  ],
  "cnpj": "09.136.712/0001-07",
  "destaque": false,
  "ficha_reivindicada": true,
  "atualizado_em": "2026-10-11",
  "criado_em": "2026-08-29"
}

Acesso premium com HTTP 402 / x402 (futuro, desativado)

A API pública continua gratuita. Está preparada uma rota futura /api/v2/premium/* (ex.: dados enriquecidos ou consultas em lote) que poderá responder 402 Payment Required no padrão x402: o servidor devolve o cabeçalho PAYMENT-REQUIRED, o agente paga e repete a chamada com PAYMENT-SIGNATURE, e a resposta traz PAYMENT-RESPONSE.

Hoje nenhum endpoint cobra nada, não há carteira configurada e nenhuma rota responde 402. O passo a passo para ativar está em docs/FUTURO.md do projeto.