> ## 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. # События сигналов компании > Обогащённая, постраничная детализация событий сигналов, определяющих экспансию отдельной компании. ## OpenAPI ````yaml ru-openapi POST /expansions/companies/pulse_events 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: /expansions/companies/pulse_events: post: tags: - Expansion summary: События сигналов компании description: >- Обогащённая, постраничная детализация событий сигналов, определяющих экспансию отдельной компании. operationId: expansions_company_pulse_events requestBody: required: true content: application/json: schema: type: object properties: signal_types: $ref: '#/components/schemas/expansion_signal_type_slugs' country_codes: type: array items: type: string example: - JP - SG description: >- Необязательно. Ограничить ленту одним или несколькими зарубежными рынками (ISO 3166-1 alpha-2, например `["JP","SG"]`). Если не указано → все зарубежные рынки (домашний рынок всегда исключается). transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- Диапазон дат ISO `[from, to]` для окна сигналов/переходов. Имеет приоритет над `window_days`, если указаны оба. window_days: type: integer example: 90 default: 90 description: >- Необязательно. Размер скользящего окна событий в днях. По умолчанию **90** (стандартное окно отображения), если не указаны ни этот параметр, ни `transitioned_dates`. Если указаны оба, приоритет имеет `transitioned_dates`. query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- Описание на естественном языке того, что вы продаёте, или профиля покупателя, по которому вы оцениваете эту компанию. Используется только для обоснования `summary` от ИИ (см. `is_explain_match`); в отличие от поиска компаний, здесь это НЕ интерпретируется в фильтры. is_explain_match: type: boolean example: true description: >- Если true и указан `query`, `data.summary` возвращает единую сводку от ИИ по активности экспансии этой компании, составленную с учётом вашего `query` и обоснованную реальными сигналами компании с цитатами `[n]`. В отличие от `match_summary` для отдельной компании в поиске компаний, эта сводка строится на ОСНОВЕ ВСЕЙ ленты компании за период (все рынки, каждый сигнал), поэтому она стабильна независимо от `page` / `per_page`. domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' anyOf: - title: Domain Search ID required: - domain_search_id - title: Domain required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: >- Постраничные события сигналов. Если `is_explain_match` равен true и указан `query`, `data.summary` содержит сводку от ИИ (`{ text, citations }`) по активности компании на основе полной ленты, составленную с учётом запроса; в противном случае — `null`. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: Контейнер результатов. properties: pagination: type: object description: >- Страница, количество на странице, общее число записей и общее число страниц. events: type: array description: События сигналов для этой компании, от самых новых. items: type: object summary: type: object description: >- Необязательная сводка событий на этой странице; `null`, если не вычислена. nullable: true example: metadata: filters: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c data: pagination: page: 1 per_page: 25 total_entries: 42 total_pages: 2 total_display_pages: 2 is_timeout: false events: - signal_type_slug: EXEC stage_slug: expanding country_code: US signal_subtype_slug: country_manager source_type: linkedin polarity: expansion display_label: Hired Country Manager evidence_url: https://linkedin.com/company/example-corp event_date: '2026-06-20T14:00:00.000Z' summary: text: >- Example Corp is hiring across Tokyo[1] and just added a Japan Country Manager[2], yet has no legal entity on file — it is staffing the market before incorporating, which is exactly your window. citations: - 'n': 1 type: HIRE label: Tokyo software & field-ops roles country: JP date: 2026-06 url: null - 'n': 2 type: EXEC label: Country Manager, Japan country: JP date: 2026-06 url: https://linkedin.com/in/example '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_signal_type_slugs: 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: - EXEC - HIRE description: >- Ограничить конкретными типами сигналов. Определения и уровни см. в каталоге Signal Types в базе знаний (`DNS` и `INFRA` — сигналы уровня Premier). domain: type: string example: pubrio.com description: >- Домен компании, используемый для операций поиска компаний. Если получен URL вида `www.pubrio.com` или `https://docs.pubrio.com/`, система преобразует его в `pubrio.com` для обработки. company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: >- Полностью сформированный URL профиля компании в LinkedIn. URL начинается с `http` и содержит `linkedin.com/company/` domain_search_id: type: string format: uuid description: Уникальный идентификатор операции поиска компаний. 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**. 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` для поиска компаний и людей), а не усечённый набор результатов. 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 ````