Впервые знакомитесь с концепциями (стадии, сигналы, momentum, свежесть)? Начните с Что такое сигналы экспансии? — это руководство предполагает, что вы уже их знаете, и фокусируется на выборе эндпоинта.
Выбор по задаче
Эндпоинты одним взглядом
Expansion Search
Эндпоинт для поиска. Фильтруйте компании по стадии экспансии, свежести, рынку и полному набору фирмографических характеристик компании — или передайте запрос на естественном языке
query. Список компаний с пагинацией.Expansion Overview
Агрегаты на уровне рынка: количество по стадиям, топ трансграничных потоков, активность отслеживаемых компаний. Без пагинации — снимок дашборда.
Company Expansion Detail
Одна компания на одном рынке: текущая стадия, оценка, присутствие, история переходов и подтверждающие сигналы. Снимок по конкретному рынку.
Company Signal Events
Обогащённая, постраничная лента событий сигналов компании по типам сигналов и окну дат. Детализация активности.
Compare Company Expansions
Несколько компаний бок о бок в одном вызове, с еженедельными рядами сигналов и опциональным подбором аналогов. Создан для сравнительных сеток.
Batch Company Expansion Summaries
Любой набор domain_search_id, domain или URL LinkedIn, разрешённый и возвращённый с теми же данными, что и Compare, плюс вычисленный блок сводки — без целевой компании, без подбора аналогов.
Expansion Rankings
Облегчённый список пар компания/рынок, ранжированный по оценке — минимальный набор полей, без пагинации — для быстрого отображения на карте и тепловой карте.
Expansion Signal Search
Запрашивайте сами строки сигналов — тип, подтип, силу, полярность, событие с датой, источник и URL доказательства — по компаниям и рынкам. С пагинацией, фильтруемо, без сводки по компаниям.
«Detail» против «Signal Events» — что выбрать?
Это самый частый источник путаницы, потому что оба задействуют сигналы. Разница — снимок против ленты:«Compare» против «Summaries» — что выбрать?
Оба возвращают одни и те же данные экспансии по компаниям бок о бок. Разница — в идентификаторах и постановке задачи:Compare Company Expansions в виде сетки — рынки, momentum, expansion score и главные новые направления, бок о бок.
Типичный рабочий процесс
Обнаружение
Вызовите Expansion Search со своими фильтрами (или запросом на естественном языке
query), чтобы получить компании, выходящие на целевой рынок. Установите is_explain_match: true для сводок ИИ «почему это совпадение».Углубление в компанию
Возьмите
domain_search_id из результатов и вызовите Company Expansion Detail для полного среза по рынку — стадия, присутствие, история и сигналы.Просмотр ленты активности (опционально)
Для богатого потока событий с окном по времени вызовите Company Signal Events с интересующими вас типами сигналов и диапазоном дат.
Сравнение или карта
Используйте Compare Company Expansions для сравнительной сетки, отталкивающейся от целевой компании, Batch Company Expansion Summaries, когда у вас уже есть набор компаний и вам нужны готовые метрики, либо Expansion Rankings, чтобы отобразить ранжированные точки на карте.
Общие фильтры
Эндпоинты обнаружения (Expansion Search, Expansion Overview, Expansion Rankings) принимают один и тот же словарь фильтров — фильтры экспансии (стадия, momentum, свежесть, область охвата, типы сигналов), пару направленной географии (froms / tos) и полный набор фирмографических характеристик компании (отрасль, технологии, размер по числу сотрудников, выручка, сохранённые списки). Изучите фильтры один раз в Filters Overview; допустимые значения находятся в Expansion Reference и каталоге How Expansion Signals Work.
Использование Expansion API
Аутентификация, первые вызовы, пагинация и чтение оценок.
Разобранный пример
Полный разбор пути от рынка к сигналу.