Skip to main content
POST
Обзор экспансии

Авторизации

pubrio-api-key
string
header
обязательно

Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе Settings.

Тело

application/json
froms
string[]

Рынки происхождения (ISO 3166-1 alpha-2). ОТКУДА расширяется компания — её домашние страны / страны штаб-квартиры. Используйте отдельно, чтобы найти компании, растущие из этих рынков; сочетайте с tos для конкретного коридора откуда→куда.

Пример:
tos
string[]

Целевые рынки (ISO 3166-1 alpha-2). КУДА расширяется компания. Используйте отдельно, чтобы найти все компании, выходящие на эти рынки; сочетайте с froms для конкретного коридора откуда→куда.

Пример:
exclude_froms
string[]

Рынки происхождения для исключения (ISO 3166-1 alpha-2).

Пример:
exclude_tos
string[]

Целевые рынки для исключения (ISO 3166-1 alpha-2).

Пример:
stages
enum<string>[]

Значения чувствительны к регистру и не проверяются. Нераспознанное значение молча отбрасывается, а не отклоняется: для stages, freshness, scopes и momentum весь фильтр отбрасывается, и вы получаете неотфильтрованные результаты, а для signal_types и signal_strengths фильтр применяется и не находит ничего. В любом случае ответ выглядит обычным. Получите допустимые слаги из Expansion Reference и сравните data.pagination.total_entries с вызовом без фильтров, если набор результатов выглядит некорректно.

Доступные опции:
exploring,
committing,
expanding,
scaling
Пример:
momentum
enum<string>[]

Траектория движения компании на рынке. advancing — набирает позиции, steady — удерживает позиции, pulling_back охватывает отступление и сокращение.

Не используйте здесь значения из directions в Expansion Reference. Те значения (advancing, steady, retreating, new) — это значения ответа, которые возвращаются в stage.direction; в качестве фильтра принимаются только три значения, перечисленные выше. Передача retreating или new молча отключает фильтр и возвращает неотфильтрованные результаты.

Доступные опции:
advancing,
steady,
pulling_back
Пример:
freshness
enum<string>[]

Значения чувствительны к регистру и не проверяются. Нераспознанное значение молча отбрасывается, а не отклоняется: для stages, freshness, scopes и momentum весь фильтр отбрасывается, и вы получаете неотфильтрованные результаты, а для signal_types и signal_strengths фильтр применяется и не находит ничего. В любом случае ответ выглядит обычным. Получите допустимые слаги из Expansion Reference и сравните data.pagination.total_entries с вызовом без фильтров, если набор результатов выглядит некорректно.

Доступные опции:
fresh,
cooling,
stale,
cold
Пример:
scopes
enum<string>[]

Фильтр по охвату выхода на рынок.

Доступные опции:
entering_new_market,
expanding_within_presence,
established_only
Пример:
ahead_of_pace
boolean

Ограничить парами компания/рынок, движущимися быстрее типичного темпа для этого рынка.

Пример:

false

signal_types
enum<string>[]

Значения чувствительны к регистру и не проверяются. Нераспознанное значение молча отбрасывается, а не отклоняется: для stages, freshness, scopes и momentum весь фильтр отбрасывается, и вы получаете неотфильтрованные результаты, а для signal_types и signal_strengths фильтр применяется и не находит ничего. В любом случае ответ выглядит обычным. Получите допустимые слаги из Expansion Reference и сравните data.pagination.total_entries с вызовом без фильтров, если набор результатов выглядит некорректно.

Доступные опции:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Пример:
signal_strengths
enum<string>[]

Значения чувствительны к регистру и не проверяются. Нераспознанное значение молча отбрасывается, а не отклоняется: для stages, freshness, scopes и momentum весь фильтр отбрасывается, и вы получаете неотфильтрованные результаты, а для signal_types и signal_strengths фильтр применяется и не находит ничего. В любом случае ответ выглядит обычным. Получите допустимые слаги из Expansion Reference и сравните data.pagination.total_entries с вызовом без фильтров, если набор результатов выглядит некорректно.

Доступные опции:
low,
medium,
high,
very_high
Пример:
min_signal_count
integer

Минимальное количество сигналов экспансии, которое должно быть у компании за период — «очень активна / значительное присутствие».

Пример:

3

only_contraction
boolean

Если true, вернуть только экспансии с пометкой сокращения (компании, сворачивающие деятельность).

Пример:

false

verticals
integer[]

Список значений vertical_id, используемых для поиска компаний в конкретной отрасли. Чтобы найти ID, вызовите эндпоинт vertical на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["AI"].

vertical_categories
integer[]

Список значений vertical_category_id, используемых для поиска компаний в конкретной категории отрасли. Чтобы найти ID, вызовите эндпоинт vertical category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Information Technology"].

vertical_sub_categories
integer[]

Список значений vertical_sub_category_id, используемых для поиска компаний в конкретной подкатегории отрасли. Чтобы найти ID, вызовите эндпоинт vertical sub category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Software"].

technologies
integer[]

Список значений tag_id, используемых для поиска конкретных технологий, применяемых компаниями. Чтобы найти ID, вызовите эндпоинт technology на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Shopify"].

employees
string[][]

Диапазон количества сотрудников, работающих в компании. Позволяет находить компании по численности персонала. Можно добавить несколько диапазонов, чтобы расширить результаты поиска.

Подробнее см. эндпоинты company size на вкладке Filters.

Пример:
revenues
integer[]

Минимальный и максимальный диапазон выручки компании.

Пример:
founded_dates
integer[]

Диапазон годов основания компании. Максимальное значение — текущий год.

Пример:
keywords
string[]

Список ключевых слов для фильтрации компаний по релевантности, специализациям или описаниям.

Пример:
companies
string[]

Ограничить конкретными компаниями по любому сочетанию domain_search_id, домена компании или URL профиля компании в социальных сетях. Домены и URL сопоставляются с наиболее подходящей компанией.

Пример:
job_locations
string[]

ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
job_exclude_locations
string[]

Географические местоположения, исключаемые из результатов поиска вакансий.

Пример:
job_posted_dates
string[]

Диапазон дат публикации вакансии. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:
job_titles
string[]

Должности, связанные с людьми, которых вы хотите найти.

Результаты также будут включать должности, содержащие схожую терминологию, даже если они не совпадают точно. Например, поиск по software engineer может вернуть результаты с должностью senior software engineer.

Пример:
advertisement_target_locations
string[]

Целевые географические местоположения для рекламы.

Пример:
advertisement_exclude_target_locations
string[]

Географические местоположения, исключаемые из таргетинга рекламы.

Пример:
advertisement_search_terms
string[]

Ключевые слова, используемые для поиска в содержимом или заголовках рекламы.

Пример:
advertisement_start_dates
string<date>[]

Начало диапазона дат для фильтрации рекламы.

Пример:
advertisement_end_dates
string<date>[]

Конец диапазона дат для фильтрации рекламы.

Пример:
news_categories
string[]

Список category slugs для поиска конкретных категорий новостей. Чтобы найти слаг, вызовите эндпоинт news categories на вкладке Filters.

Пример:
news_published_dates
string[]

Диапазон дат публикации. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:
transitioned_dates
string<date>[]

Диапазон дат ISO [начало, конец] для окна отображения (карта, потоки и хронология списка наблюдения). По умолчанию — последние 90 дней. Показатель new_transitions_30d всегда использует собственное фиксированное 30-дневное окно независимо от этого диапазона.

Пример:
window_days
integer

Необязательно. Размер скользящего окна в днях. Используется, когда явный диапазон transitioned_dates не указан; если не указаны оба, используется окно по умолчанию.

Пример:

90

min_markets
integer

Минимальное количество новых рынков, на которые должна была выйти компания за период (широко экспандирующие компании).

Пример:

3

home_country_code
string[]

Фильтр по стране происхождения компании (ISO 3166-1 alpha-2). Пересекается с froms, если указаны оба.

Пример:
industries
string[]

Фильтр по названию отрасли (сопоставление по свободному тексту).

Пример:
exclude_industries
string[]

Отрасли для исключения (сопоставление по свободному тексту).

Пример:
select_size
integer

Максимальное количество возвращаемых рынков (ограничено тарифом).

Пример:

250

flows_size
integer

Максимальное количество возвращаемых трансграничных потоков (ограничено тарифом).

Пример:

50

is_include_metadata
boolean

Вернуть полную детализированную полезную нагрузку. По умолчанию трафик по ключу API компактный: блок model, показатели достоверности (stage.confidence в Company Expansion Detail, confidence_score в other_markets[] и в markers[] Rankings), а также поля established_min / share_of_detected / has_known_office опускаются, если это значение не true.

Пример:

true

Включить сопоставление по свободному тексту для verticals, vertical_categories, vertical_sub_categories и technologies; эти фильтры отбрасываются, если это значение не true.

Пример:

true

Ответ

Агрегированные данные панели рынков.

metadata
object
data
object

Контейнер панели: ранжированные рынки плюс основные потоки по коридорам. Устаревшее зеркальное отображение. Каждый контейнер внутри data также выводится на верхнем уровне (countries, top_flows, picks_aggregate, watchlist_markets, watchlist_timeline) для более старых клиентов. Считывайте их из data — копии на верхнем уровне будут удалены.