B2B Integration Guide & Whitelabel

API de Geomarketing & Revenda Corporativa

Integre nosso motor científico de viabilidade de pontos diretamente no seu CRM imobiliário, portal de imóveis comerciais ou sistema interno de expansão de franquias.

1. Autenticação

Todas as requisições autenticadas devem incluir a sua chave de revenda no cabeçalho HTTP Authorization:

Authorization: Bearer REV_SEU_TOKEN_AQUI_2026

2. Executar Análise de Ponto Comercial

Consome 1 crédito do seu saldo contratado e retorna o laudo completo com Modelos de Huff, Christaller, Censo IBGE e concorrência mapeada.

POST /api/v1/reseller/analise

Payload de Envio (JSON):

{
  "endereco": "Av. Brigadeiro Faria Lima, 2232, São Paulo, SP",
  "nicho": "alimentacao_restaurantes",
  "webhook_callback": "https://seusite.com.br/webhook/ponto-concluido"
}
    

Exemplo cURL:

curl -X POST "http://SEU_VPS:14721/api/v1/reseller/analise" \
  -H "Authorization: Bearer REV_TESTE_DEMO_2026" \
  -H "Content-Type: application/json" \
  -d '{
    "endereco": "Av. Afonso Pena, 1500, Belo Horizonte, MG",
    "nicho": "farmacias_drogarias"
  }'
    

Exemplo em Python:

import requests

url = "http://SEU_VPS:14721/api/v1/reseller/analise"
headers = {
    "Authorization": "Bearer REV_TESTE_DEMO_2026",
    "Content-Type": "application/json"
}
payload = {
    "endereco": "Rua Oscar Freire, 800, São Paulo, SP",
    "nicho": "vestuario_calcados"
}

response = requests.post(url, json=payload, headers=headers)
laudo = response.json()
print("Score do Ponto:", laudo["analise"]["score_final"])
print("Faturamento Mensal Projetado:", laudo["analise"]["potencial_consumo_censo"]["faturamento_projetado_loja_mes_rs"])
    

Exemplo da Resposta JSON (200 OK):

{
  "status": "success",
  "parceiro": "Imobiliária Prime Demo",
  "saldo_restante": 99,
  "relatorio_id": "B2B_E4F982A1",
  "analise": {
    "endereco": "Rua Oscar Freire, 800, São Paulo, SP",
    "score_final": 8.7,
    "nivel_potencial": "Excelente (Ponto de Altíssimo Retorno)",
    "modelo_huff": {
      "probabilidade_escolha_pct": 21.4,
      "fator_atrito_lambda": 1.5,
      "concorrentes_analisados_1km": 6
    },
    "teoria_christaller": {
      "raio_500m_pedestres": { "populacao": 6420, "domicilios": 2378, "concorrentes": 1 },
      "raio_1000m_bairro": { "populacao": 18950, "domicilios": 7018, "concorrentes": 4 },
      "raio_2000m_estendido": { "populacao": 52100, "domicilios": 19296, "concorrentes": 8 }
    },
    "potencial_consumo_censo": {
      "renda_media_domiciliar_rs": 6450.00,
      "faturamento_projetado_loja_mes_rs": 142500.00
    }
  }
}
    

3. Tabela Comercial de Créditos B2B

Pacote de Créditos	Consultas Inclusas	Custo Unitário / Consulta	Valor Total	Margem de Lucro Recomendada na Revenda
Starter B2B	50 consultas	R$ 14,90	R$ 745,00	Revenda a R$ 67,90 (Lucro de 355%)
Growth Imobiliário	200 consultas	R$ 9,90	R$ 1.980,00	Revenda a R$ 67,90 (Lucro de 585%)
Franchise Enterprise	1.000 consultas	R$ 5,90	R$ 5.900,00	Uso ilimitado em rede própria ou portais