Signals API · v1

Nákupní signály hotelů dodávané jako data

Stejné ručně ověřené nákupní signály, které stojí za našimi čtvrtletními reporty – otevření nových hotelů, rekonstrukce a změny ve vedení – jako strukturovaný JSON, se kterým může vaše CRM pracovat: kontrola duplicit, směrování podle regionů, automatické vytváření leadů.

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

Přehled API

Jeden endpoint, tři filtry

Autentizujte se pomocí svého API klíče v hlavičce Authorization: Bearer. Dotazujte se podle svého plánu – feed se aktualizuje, jakmile nová dávka signálů projde ručním ověřením, a parametr since usnadňuje přírůstkové stahování dat.Authorization: Bearersince

Parametr Formát Co to dělá
since YYYY-MM-DD Pouze signály s datem události v tento den nebo po něm.
market e.g. Saudi Arabia Omezit na jeden nebo více trhů. Lze opakovat.
event_type NEW_OPENING · RENOVATION · MANAGEMENT_CHANGE Omezit na jeden nebo více typů signálů. Lze opakovat.

Každý signál obsahuje

signal_id

Stabilní jedinečné ID – použijte je ke sledování doručení a zabránění opakovanému zpracování.

event_type

NEW_OPENING, RENOVATION nebo MANAGEMENT_CHANGE.

market / territory

Trh je pevně daný; region se namapuje na strukturu vašeho obchodního týmu během onboardingu.

property, event_date, detail

Ověřený fakt: který hotel, kdy a co se stalo.

buying_window_note

Co signál znamená pro dodavatele – která kategorie se právě specifikuje a kdy jednat.

source_name / source_url

Každý signál odkazuje na svůj veřejný zdroj. Žádné modelované ani neověřeně odhadnuté záznamy ze scrapování.

rating

Spoludefinováno s vaším týmem podle vašich kritérií (fáze projektu, rozsah, relevance kategorie).

Doručení

Vyberte si moduly, které váš technologický stack potřebuje

Rozsah je modulární – začněte s datovým feedem, a jakmile váš proces dozraje, přidejte moduly pro doručování a CRM. Žádný veřejný ceník: sdělte nám své nastavení a my vám naceníme přesný rozsah.

JSON Feed

Zahrnuto

Autentizovaný REST endpoint, který vaše systémy dotazují podle vlastního plánu. Filtry pro trh, typ signálu a datum. Deklarovaný deduplikační klíč pro kontrolu duplicit vůči vašemu CRM.

Doručování přes webhooky

K dispozici

Podepsané push notifikace zcela nových ověřených signálů na váš endpoint v okamžiku, kdy dávka projde ručním ověřením. Funguje s jakýmkoli integračním middlewarem.

HubSpot / Salesforce

Na vyžádání

Přímé vytváření leadů s nativním řešením duplicit – upsert na základě externího ID, vaše mapování polí, vaše fáze obchodní příležitosti.

SAP Sales Cloud

Design partner

Automatizované vytváření leadů přes OData, které je před jakýmkoli zásahem do produkčního prostředí ověřeno ve vašem testovacím tenantu (sandboxu). Vyvinuto společně s vaším integračním týmem.

Kvalita dat

Ručně ověřené, s odkazem na zdroj, verzované

Náš systém denně zpracovává více než 65 oborových zdrojů, ale nic se do API nedostane čistě automaticky – každý signál před doručením ověřuje člověk a každý záznam odkazuje na svůj veřejný zdroj. Schéma je verzované, takže to, co vaše integrace zpracovává dnes, bude bez problémů fungovat i nadále.

  • ✓ Deklarovaný deduplikační klíč u každého záznamu (payloadu), navržený pro kontrolu duplicit vůči vašim stávajícím záznamům v CRM.
  • ✓ Pole pro hodnocení a regiony definovaná společně s vaším obchodním týmem, aby data mluvila jazykem vašeho prodejního procesu.
  • ✓ Žádné umělé navyšování počtů. Pokud má čtvrtletí 33 ověřených signálů, API jich vykáže přesně 33.

Hodnocení

Jak funguje pilotní projekt

Kritéria úspěchu si odsouhlasíme ještě před spuštěním, aby bylo vyhodnocení objektivní – podíl zcela nových leadů, přesnost dat, pokrytí regionů.

01

Zpětný test (back-test)

~2 týdny

Vyberete si regiony a kategorie projektů. My vám dodáme kompletní sadu signálů za posledních 90 dní ve formátu JSON. Váš tým provede kontrolu duplicit vůči vašemu CRM a společně vyhodnotíme podíl zcela nových leadů, přesnost a pokrytí.

02

Živý pilotní provoz

4–6 týdnů

Týdenní doručování nově ověřených signálů s vyplněným hodnocením a regionem podle našich společných definic. Volitelně také automatické vytváření leadů v sandboxu vašeho CRM.

Jste připraveni otestovat si to na vlastním CRM?

Sdělte nám své regiony, kategorie projektů a typ CRM. Navrhneme rozsah pilotního projektu a vystavíme vám API klíč.

Požádat o přístup k API →