Skip to main content
POST
Поиск новостей о компаниях

Авторизации

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

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

Тело

application/json
locations
string[]

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

Пример:
company_locations
string[]

Местоположение штаб-квартиры компании. Подробнее см. эндпоинты location на вкладке Filters.

Пример:
companies
string<uuid>[]

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

news_search_id
string<uuid>

Вернуть только эту одну запись. Удобно для повторного получения ранее сохранённой строки без постраничной навигации.

Пример:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида www.pubrio.com или https://docs.pubrio.com/, система преобразует его в pubrio.com для обработки.

Пример:
linkedin_urls
string[]

Полностью сформированный URL профиля компании в LinkedIn. URL начинается с http и содержит linkedin.com/company/

Пример:
search_term
string

Строка слов, по которой мы фильтруем результаты.

Пример:

"pubrio"

search_terms
string[]

Массив ключевых слов для фильтрации новостных статей. Каждый термин сопоставляется с содержимым статьи. Используйте search_term для одной строки или search_terms для нескольких ключевых слов.

Пример:
categories
string[]

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

Пример:

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

published_dates
string[]

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

Пример:
published_at
string<date-time>

Опубликовано в этот момент времени (UTC) или позже. Дата или временная метка ISO. published_dates — форма с закрытым диапазоном, использующая часовой пояс вашей рабочей области.

Пример:

"2026-09-01T00:00:00Z"

per_page
integer
по умолчанию:25

Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром max_search_per_page вашей подписки, который возвращает Profile. Превышение возвращает HTTP 416 с кодом 41676 (или 41613 для поиска компаний и людей), а не усечённый набор результатов.

Требуемый диапазон: x <= 25
Пример:

25

page
integer
по умолчанию:1

Номер страницы, начиная с 1. Предел определяется параметром max_search_page вашей подписки (max_company_search_page для поиска компаний), который возвращает Profile. Превышение возвращает HTTP 416.

Пример:

1

is_ascending_order
boolean
по умолчанию:false

Направление сортировки. По умолчанию результаты возвращаются от самых новых; установите true для сортировки от самых старых. У этого эндпоинта нет sort_by — ключ сортировки фиксирован и указан в описании эндпоинта.

Пример:

false

news_galleries
string[]

Список gallery slugs для фильтрации новостей по галерее. Чтобы найти slug, вызовите эндпоинт news galleries на вкладке Filters.

Пример:
news_languages
string[]

Список значений locale_code для фильтрации новостей по языку. Чтобы найти доступные коды, вызовите эндпоинт news languages на вкладке Filters.

Пример:
is_expansion_signal_available
boolean

Если true, к каждой новости прикрепляются сопоставленные сигналы экспансии (expansion_signals) и включаются фильтры expansion_signal_types / expansion_signal_polarities. Оставьте неустановленным для самого быстрого поиска — присоединение данных экспансии добавляется только при включении этого флага.

expansion_signal_types
enum<string>[]

Вернуть только новости, породившие сигнал экспансии одного из этих типов (слаги в верхнем регистре). Требует is_expansion_signal_available: true. Неизвестные слаги игнорируются.

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

Вернуть только новости, чей сигнал экспансии несёт одну из этих полярностей. Требует is_expansion_signal_available: true. Сочетается с expansion_signal_types через AND.

Доступные опции:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Пример:

Ответ

Успешный ответ с данными поиска новостей о компании.

metadata
object

Контекст запроса.

data
object
Последнее изменение 4 сентября 2026 г.