Signals API · v1

Hotel buying signals, delivered as data

The same human-verified procurement signals behind our quarterly reports — openings, renovations and leadership changes — as structured JSON your CRM can act on: duplicate checks, territory routing, automatic lead creation.

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
  }]
}

Reference

One endpoint, three filters

Authenticate with your API key in the Authorization: Bearer header. Poll on your schedule — the feed updates when a new batch of signals clears human verification, and the since parameter makes incremental pulls trivial.

Parameter Format What it does
since YYYY-MM-DD Only signals with an event date on or after this date.
market e.g. Saudi Arabia Limit to one or more markets. Repeatable.
event_type NEW_OPENING · RENOVATION · MANAGEMENT_CHANGE Limit to one or more signal types. Repeatable.

Every signal carries

signal_id

Stable unique ID — use it to track deliveries and avoid re-processing.

event_type

NEW_OPENING, RENOVATION or MANAGEMENT_CHANGE.

market / territory

Market is fixed; territory is mapped to your sales structure during onboarding.

property, event_date, detail

The verified fact: which property, when, and what happened.

buying_window_note

What the signal means for a supplier — which category is being specified and when to act.

source_name / source_url

Every signal links to its public origin. No modelled or scraped-guess rows.

rating

Co-defined with your team against your criteria (project stage, scale, category relevance).

Delivery

Pick the modules your stack needs

Scope is modular — start with the feed, add delivery and CRM modules as your process matures. No public price list: tell us your setup and we quote the exact scope.

JSON Feed

Included

Authenticated REST endpoint your systems poll on your schedule. Filters for market, signal type and date. Declared dedupe key for duplicate checks against your CRM.

Webhook Delivery

Available

Signed pushes of net-new verified signals to your endpoint the moment a batch clears human verification. Works with any integration middleware.

HubSpot / Salesforce

On request

Direct lead creation with native duplicate handling — external-ID upserts, your field mapping, your pipeline stage.

SAP Sales Cloud

Design partner

Automated lead creation via OData, validated against your sandbox tenant before anything touches production. Built jointly with your integration team.

Data quality

Human-verified, source-linked, versioned

Our engine ingests 65+ industry sources daily, but nothing reaches the API on automation alone — every signal is verified by a person before delivery, and every row links to its public source. The schema is versioned, so what your integration parses today keeps parsing.

  • A declared dedupe key on every payload, built for duplicate checks against your existing CRM records.
  • Rating and territory fields co-defined with your sales team, so the feed speaks your pipeline's language.
  • No padded counts. If a quarter has 33 verified signals, the API says 33.

Evaluation

How a pilot works

Success criteria are agreed before we start, so the evaluation is objective — net-new lead share, data accuracy, territory coverage.

01

Retrospective back-test

~2 weeks

You pick territories and project categories. We deliver the full 90-day signal set as JSON. Your team runs the duplicate check against your CRM and we jointly measure net-new share, accuracy and coverage.

02

Live pilot

4–6 weeks

Weekly delivery of newly verified signals with rating and territory populated to the definitions we agree. Optionally, automated lead creation into your CRM sandbox.

Ready to test it against your CRM?

Tell us your territories, project categories and CRM. We'll propose a scoped pilot and issue your API key.

Request API access →