> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Поиск новостей компании > Поиск новостей о компаниях. См. [руководство по поиску новостей](/en/developer-guides/search/news-search). ## OpenAPI ````yaml ru-openapi POST /companies/news/search openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Информация о профиле рабочей области и статистика использования - name: Enrichment description: Обогащение записей о людях и компаниях подробными B2B-данными - name: Lookalike description: Поиск компаний, похожих на заданную компанию - name: Search description: >- Поиск людей, компаний, вакансий, новостей и рекламы с использованием фильтров - name: Lookup description: >- Просмотр подробной информации о конкретных людях, компаниях, вакансиях, новостях, рекламе и технологиях - name: LinkedIn description: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. url: https://docs.pubrio.com paths: /companies/news/search: post: tags: - Search summary: Поиск новостей о компаниях description: >- Поиск новостей о компаниях. См. [руководство по поиску новостей](/en/developer-guides/search/news-search). operationId: companies_search_news parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' news_search_id: allOf: - $ref: '#/components/schemas/news_search_id' description: >- Вернуть только эту одну запись. Удобно для повторного получения ранее сохранённой строки без постраничной навигации. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' search_term: $ref: '#/components/schemas/search_term' search_terms: type: array items: type: string example: - Trump description: >- Массив ключевых слов для фильтрации новостных статей. Каждый термин сопоставляется с содержимым статьи. Используйте `search_term` для одной строки или `search_terms` для нескольких ключевых слов. categories: $ref: '#/components/schemas/news_categories' news_gallery_ids: $ref: '#/components/schemas/news_gallery_ids' published_dates: $ref: '#/components/schemas/published_dates' published_at: $ref: '#/components/schemas/news_published_at_from' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' news_galleries: type: array items: type: string example: - electronic-commerce description: >- Список `gallery slugs` для фильтрации новостей по галерее. Чтобы найти slug, вызовите эндпоинт `news galleries` на вкладке Filters. news_languages: type: array items: type: string example: - en description: >- Список значений `locale_code` для фильтрации новостей по языку. Чтобы найти доступные коды, вызовите эндпоинт `news languages` на вкладке Filters. is_expansion_signal_available: $ref: '#/components/schemas/is_expansion_signal_available' expansion_signal_types: $ref: '#/components/schemas/expansion_signal_types' expansion_signal_polarities: $ref: '#/components/schemas/expansion_signal_polarities' responses: '200': description: Успешный ответ с данными поиска новостей о компании. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' news: type: array items: $ref: '#/components/schemas/news_search_result' example: metadata: profile: null filters: domains: - stripe.com per_page: 25 language: en ignored_fields: [] data: pagination: page: 1 per_page: 25 total_entries: 351800 total_pages: 14072 is_timeout: false total_display_pages: 250 news: - news_id: 0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd news_search_id: 4110b929-17cd-42aa-a159-906ead0c9b56 country_codes: - CN - SG company_country_codes: - CN - FR domains: - insead.edu - digitalchina.com companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: dfbe6797-5311-46f9-9518-bf1a7c3d09bc country_code: FR company_name: Insead linkedin_name: insead domain: insead.edu - logo_url: >- https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: e13a9e24-a07d-4630-9b47-fceb778df74e country_code: CN company_name: Digital China linkedin_name: digital-china domain: digitalchina.com news_galleries: - slug: banking-financial-service news_gallery_id: 7c8ec9cc-66c5-4153-82da-9c8f356c6c99 name: Banking/Financial Service locations: - Singapore - China last_modified: '2025-06-01T08:15:23.945Z' image_url: null url: http://enold.prnasia.com/p/asia-story-125304015-0.shtml published_at: '2025-06-01T08:00:00.000Z' language: id source: prnasia.com category: launches title: >- Digital China's AI-driven transformation showcased at INSEAD summary: >- Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey. news_category_name: Launches - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: locations: type: array items: type: string example: - US - SG - CN description: >- ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты `location` на вкладке Filters. company_locations: type: array items: type: string example: - US - SG - CN description: >- Местоположение штаб-квартиры компании. Подробнее см. эндпоинты `location` на вкладке Filters. companies: type: array items: type: string format: uuid description: >- Список уникальных идентификаторов (domain_search_id), используемых для операций поиска компаний и людей. news_search_id: type: string format: uuid example: 4110b929-17cd-42aa-a159-906ead0c9b56 description: Уникальный идентификатор операции поиска новостей компании. domains: type: array items: type: string example: - pubrio.com description: >- Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида `www.pubrio.com` или `https://docs.pubrio.com/`, система преобразует его в `pubrio.com` для обработки. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- Полностью сформированный URL профиля компании в LinkedIn. URL начинается с `http` и содержит `linkedin.com/company/` search_term: type: string example: pubrio description: Строка слов, по которой мы фильтруем результаты. news_categories: type: array items: type: string example: - launches description: >- Список `category slugs` для поиска конкретных категорий новостей. Чтобы найти слаг, вызовите эндпоинт `news categories` на вкладке Filters. news_gallery_ids: type: array items: type: string format: uuid description: >- Список значений `news_gallery_id`, используемых для поиска конкретных галерей новостей. Чтобы найти ID, вызовите эндпоинт `news galleries` на вкладке Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Диапазон дат публикации. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области. news_published_at_from: type: string format: date-time example: '2026-09-01T00:00:00Z' description: >- Опубликовано в этот момент времени (UTC) или позже. Дата или временная метка ISO. `published_dates` — форма с закрытым диапазоном, использующая часовой пояс вашей рабочей области. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром `max_search_per_page` вашей подписки, который возвращает [Profile](/en/api-reference/endpoint/profile/profile). Превышение возвращает **HTTP 416** с кодом `41676` (или `41613` для поиска компаний и людей), а не усечённый набор результатов. page: type: integer example: 1 default: 1 description: >- Номер страницы, начиная с 1. Предел определяется параметром `max_search_page` вашей подписки (`max_company_search_page` для поиска компаний), который возвращает [Profile](/en/api-reference/endpoint/profile/profile). Превышение возвращает **HTTP 416**. is_ascending_order: type: boolean default: false example: false description: >- Направление сортировки. По умолчанию результаты возвращаются от самых новых; установите `true` для сортировки от самых старых. У этого эндпоинта нет `sort_by` — ключ сортировки фиксирован и указан в описании эндпоинта. is_expansion_signal_available: type: boolean description: >- Если `true`, к каждой новости прикрепляются сопоставленные сигналы экспансии (`expansion_signals`) и включаются фильтры `expansion_signal_types` / `expansion_signal_polarities`. Оставьте неустановленным для самого быстрого поиска — присоединение данных экспансии добавляется только при включении этого флага. expansion_signal_types: type: array items: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: - HIRE - PARTNER description: >- Вернуть только новости, породившие сигнал экспансии одного из этих типов (слаги в верхнем регистре). Требует `is_expansion_signal_available: true`. Неизвестные слаги игнорируются. expansion_signal_polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging example: - expansion description: >- Вернуть только новости, чей сигнал экспансии несёт одну из этих полярностей. Требует `is_expansion_signal_available: true`. Сочетается с `expansion_signal_types` через AND. search_metadata: type: object description: Контекст запроса. properties: profile: type: object nullable: true description: >- Кредитный блок (`credit`, `topup_credit`, `total_credit_cost`), если запрошен учёт кредитов; `null` для обычного трафика по ключу API. filters: type: object description: >- Отражение тела запроса в том виде, в каком его применил эндпоинт, включая значения по умолчанию, такие как `per_page` и `language`. ignored_fields: type: array items: type: string description: >- Ключи тела запроса, которые эндпоинт не распознал и отбросил. Пусто означает, что все ключи были применены — опечатка в фильтре расширяет поиск, а не приводит к ошибке. search_pagination: type: object description: Пагинация для набора результатов. properties: page: type: integer description: Номер текущей страницы. per_page: type: integer description: Записей на странице. total_entries: type: integer description: >- Общее число соответствующих записей. При широком поиске без привязки к компании это приблизительная оценка. total_pages: type: integer description: '`total_entries`, делённое на `per_page`.' total_display_pages: type: integer description: >- Страницы, которые можно фактически запросить, ограничены параметром `max_search_page` вашего тарифа. is_timeout: type: boolean description: >- `true`, если запрос подсчёта превысил тайм-аут и `total_entries` является приблизительной оценкой. news_search_result: type: object description: Одна новостная статья. properties: news_id: type: string format: uuid description: Идентификатор статьи. news_search_id: type: string format: uuid description: Идентификатор записи поиска. Передайте его в News Lookup. title: type: string description: Заголовок. summary: type: string description: Краткая сводка статьи. nullable: true url: type: string description: Ссылка на статью. source: type: string description: Домен издателя. nullable: true image_url: type: string description: Главное изображение, если у статьи оно есть. nullable: true language: type: string description: >- Код языка статьи по ISO 639-1. Тот же словарь, что и фильтр `news_languages`. nullable: true published_at: type: string format: date-time description: >- Время публикации. Это ключ сортировки по умолчанию (статьи без даты идут последними). nullable: true last_modified: type: string format: date-time description: Когда запись была последний раз обновлена. category: type: string description: >- Слаг категории новости. Тот же словарь, что и фильтр `categories` и эндпоинт News Categories. nullable: true news_category_name: type: string description: Понятное человеку название категории, локализованное по `language`. nullable: true news_galleries: type: array nullable: true items: type: object properties: news_gallery_id: type: string format: uuid slug: type: string name: type: string description: Галереи, к которым относится статья; `null`, если ни одной. country_codes: type: array nullable: true items: type: string description: >- Страны, о которых говорится в статье (ISO 3166-1 alpha-2); `null`, если не определено. Тот же словарь, что и фильтр `locations`. company_country_codes: type: array nullable: true items: type: string description: >- Страны штаб-квартир упомянутых компаний. Тот же словарь, что и фильтр `company_locations`. locations: type: array nullable: true items: type: string description: Названия мест, упомянутых в статье; `null`, если ни одного. domains: type: array items: type: string description: Домены всех компаний, упомянутых в статье. companies: type: array items: $ref: '#/components/schemas/search_result_company' description: >- Все компании, упомянутые в статье, в том же порядке, что и `domains`. expansion_signals: type: array items: type: object properties: signal_type_slug: type: string description: Тип сигнала, например `HIRE`, `PARTNER`, `PRODUCT`. signal_subtype_slug: type: string description: Подтип сигнала, если у типа он есть. nullable: true signal_strength_slug: type: string description: 'Сила сигнала: `low`, `medium`, `high`, `very_high`.' polarity: type: string description: >- `expansion`, `contraction_leading`, `contraction_confirming` или `contraction_lagging`. country_code: type: string description: Рынок, на который указывает сигнал. nullable: true domain_search_id: type: string format: uuid description: Компания, к которой относится сигнал. event_date: type: string format: date-time description: Когда произошёл сигнал. description: >- Только если `is_expansion_signal_available: true`: сигналы экспансии, порождённые этой статьёй. Пустой массив, если их нет. search_result_company: type: object description: Компания, с которой связана эта запись. properties: domain_search_id: type: string format: uuid description: >- Идентификатор компании в Pubrio. Передайте его в `companies` при любом поиске или в Company Lookup. company_name: type: string description: Название компании. linkedin_name: type: string nullable: true description: Слаг компании в LinkedIn (часть после `linkedin.com/company/`). country_code: type: string nullable: true description: Код ISO 3166-1 alpha-2 штаб-квартиры компании. company_url: type: string nullable: true description: URL веб-сайта компании. domain: type: string description: Домен компании, нормализованный (`stripe.com`). logo_url: type: string nullable: true description: URL логотипа компании. responses: general_error: description: >- Некорректный запрос. Запрос был некорректно сформирован или содержал недопустимые параметры. Подробности см. в коде и сообщении об ошибке. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Превышен лимит запросов. За заданный период времени было сделано слишком много запросов. Повторите попытку после сброса окна лимита запросов. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Внутренняя ошибка сервера. На сервере произошла непредвиденная ошибка. Если ошибка повторяется, обратитесь в службу поддержки. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````