API de Sinais · v1

Sinais de compra do setor hoteleiro, entregues como dados

Os mesmos sinais de compra verificados por humanos que sustentam os nossos relatórios trimestrais — aberturas, remodelações e mudanças na direção — em formato JSON estruturado para o seu CRM processar: verificação de duplicados, atribuição por território e criação automática de leads.

GET https://www.innlead.ai/api/v1/signals?since=2026-06-01&market=Saudi%20Arabia

{
  "meta": {
    "provider": "InnLead.ai",
    "schema_version": "1.0",
    "verified_signal_count": 33,
    "dedupe_key": ["property", "market",
                   "event_type", "source_url"]
  },
  "signals": [{
    "signal_id": "INL-2026Q3-001",
    "event_type": "NEW_OPENING",
    "market": "Saudi Arabia",
    "property": "NH Riyadh Prime Square",
    "event_date": "2026-06-29",
    "buying_window_note": "Design and casegoods
      specification is years out — the earliest
      relationship window for FF&E suppliers.",
    "source_url": "https://...",
    "rating": null
  }]
}

Referência

Um único endpoint, três filtros

Autentique-se com a sua chave de API no cabeçalho Authorization: Bearer. Consulte ao seu próprio ritmo — o feed é atualizado sempre que um novo lote de sinais passa pela verificação humana, e o parâmetro since torna triviais as extrações incrementais.Authorization: Bearersince

Parâmetro Formato O que faz
since YYYY-MM-DD Apenas sinais com data de evento igual ou posterior a esta data.
market e.g. Saudi Arabia Limitar a um ou mais mercados. Repetível.
event_type NEW_OPENING · RENOVATION · MANAGEMENT_CHANGE Limitar a um ou mais tipos de sinal. Repetível.

Cada sinal contém

signal_id

ID único e estável — use-o para rastrear entregas e evitar reprocessamento.

event_type

NEW_OPENING, RENOVATION ou MANAGEMENT_CHANGE.

market / territory

O mercado é fixo; o território é mapeado para a sua estrutura comercial durante o onboarding.

property, event_date, detail

O facto verificado: que propriedade, quando e o que aconteceu.

buying_window_note

O que o sinal significa para um fornecedor — que categoria está a ser especificada e quando agir.

source_name / source_url

Cada sinal remete para a sua origem pública. Sem linhas modeladas ou obtidas por estimativa de scraping.

rating

Definido em conjunto com a sua equipa, segundo os seus critérios (fase do projeto, escala, relevância da categoria).

Entrega

Escolha os módulos de que a sua stack precisa

O âmbito é modular — comece com o feed e adicione módulos de entrega e CRM à medida que o seu processo amadurece. Sem tabela de preços pública: indique-nos a sua stack e enviaremos uma proposta para o âmbito exato.

Feed JSON

Incluído

Endpoint REST autenticado que os seus sistemas consultam ao seu próprio ritmo. Filtros por mercado, tipo de sinal e data. Chave de desduplicação declarada para verificação de duplicados no seu CRM.

Entrega via Webhook

Disponível

Envios assinados de sinais verificados totalmente novos diretamente para o seu endpoint no exato momento em que um lote passa pela verificação humana. Compatível com qualquer middleware de integração.

HubSpot / Salesforce

Sob consulta

Criação direta de leads com tratamento nativo de duplicados — upserts por ID externo, mapeamento de campos personalizado e a sua fase do pipeline.

SAP Sales Cloud

Parceiro de design

Criação automatizada de leads via OData, validada no seu ambiente de sandbox antes de qualquer envio para produção. Desenvolvido em conjunto com a sua equipa de integração.

Qualidade dos dados

Verificado por humanos, com ligação à fonte e controlo de versões

O nosso motor processa mais de 65 fontes do setor diariamente, mas nada chega à API apenas por automação — cada sinal é verificado por uma pessoa antes do envio, e cada linha tem ligação à sua fonte pública. O esquema tem controlo de versões, pelo que o que a sua integração interpreta hoje continua a ser interpretado amanhã.

  • Uma chave de desduplicação declarada em cada payload, desenvolvida para verificação de duplicados em relação aos registos existentes no seu CRM.
  • Campos de classificação e território definidos em conjunto com a sua equipa de vendas, para que o feed fale a mesma língua do seu pipeline.
  • Sem inflar números. Se um trimestre tiver 33 sinais verificados, a API apresentará exatamente 33.

Avaliação

Como funciona o piloto

Os critérios de sucesso são acordados antes do início, garantindo uma avaliação objetiva — quota de leads totalmente novos, precisão dos dados e cobertura de território.

01

Backtest retrospetivo

~2 semanas

Escolhe os territórios e as categorias de projeto. Nós entregamos o conjunto completo de sinais dos últimos 90 dias em formato JSON. A sua equipa faz a verificação de duplicados no seu CRM e, juntos, medimos a quota de leads totalmente novos, a precisão e a cobertura.

02

Piloto ao vivo

4–6 semanas

Envio semanal de novos sinais verificados, com classificação e território preenchidos de acordo com as definições acordadas. Opcionalmente, criação automatizada de leads no sandbox do seu CRM.

Pronto para testar no seu CRM?

Indique-nos os seus territórios, categorias de projeto e CRM. Proporemos um piloto com âmbito definido e emitiremos a sua chave de API.

Solicitar acesso à API →