> ## 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 /companies/advertisements/insights 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/advertisements/insights: post: tags: - Insights summary: Данные по рекламе description: >- Агрегированные данные рекламных сигналов для компании за период: количество активных и запущенных объявлений, распределение по каналам и площадкам, примеры креативов, охват аудитории в виде распределения по уровням и еженедельный временной ряд. Охват указывается как распределение по уровням, а не в виде единой суммарной цифры. operationId: companies_advertisements_insights requestBody: required: true content: application/json: schema: type: object required: - domain_search_id properties: domain_search_id: $ref: '#/components/schemas/domain_search_id' date_from: $ref: '#/components/schemas/date_from' date_to: $ref: '#/components/schemas/date_to' is_include_unlinked_companies: type: boolean example: false description: >- Включить рекламу, ещё не связанную с проверенным профилем компании. responses: '200': description: Блоки рекламных данных для компании и периода. content: application/json: schema: type: object properties: data: type: object description: Блоки данных для запрошенной компании и периода. properties: postings: type: array description: >- Сводка по объёму рекламы, сгруппированная по уровню охвата, рынкам, каналу и формату. Ключи сокращены для уменьшения размера полезной нагрузки: `r` — слаг уровня охвата (соответствует `reach_tiers[].slug`, `null`, если платформа не сообщает охват), `m` — рынки по ISO 3166-1 alpha-2, на которых показывалась реклама, `ch` — исходный канал, `fo` — формат рекламы, `n` — количество объявлений в этой группе. items: type: object reach_tiers: type: array description: >- Каталог меток уровней охвата, упорядоченный от наименьшего к наибольшему. Это справочная таблица, а не распределение — она не содержит количеств. Сопоставьте `postings[].r` со `slug`, чтобы получить понятную метку, и считывайте объём по уровню из `postings[].n`. Охват рекламы изначально задаётся как текстовый диапазон, поэтому уровни никогда не следует суммировать в единую цифру охвата. items: type: object creatives: type: array description: >- Недавние рекламные креативы, с приоритетом изображений: сначала идут креативы с реальным изображением, затем недавние текстовые или видеообъявления, чтобы рекламодатели без изображений тоже были представлены. `headline`, `body` и `cta` могут быть равны `null`. Здесь есть всё необходимое для отображения галереи креативов — повторный вызов поиска рекламы не требуется. items: type: object example: data: totals: total: 14 launched: 4 active: 4 markets: 46 channels: 2 weekly_series: - week_start: '2026-05-25' count: 4 postings: - r: 10k_50k m: - PE - KR - VE - AR ch: facebook fo: video 'n': 1 placement_mix: - key: INSTAGRAM count: 10 creatives: - advertisement_search_id: 29fbc4ec-d9f2-40dc-be00-c96856271f8c image_url: >- https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg headline: null cta: Learn more advertisement_url: https://www.facebook.com/ads/library?id=1234567890 destination_url: https://www.instagram.com/youtube advertiser: YouTube body: this video lives rent free in our minds format: image has_video: false reach_tiers: - slug: lt_1k label: < 1K - slug: 1k_10k label: 1K–10K - slug: 10k_50k label: 10K–50K - slug: 50k_100k label: 50K–100K - slug: 100k_500k label: 100K–500K window_days: 90 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: domain_search_id: type: string format: uuid description: Уникальный идентификатор операции поиска компаний. date_from: type: string format: date example: '2026-01-01' description: >- Начало диапазона дат (ISO 8601, ГГГГ-ММ-ДД). Используйте вместе с `date_to`, чтобы ограничить результаты конкретным диапазоном; не указывайте оба, чтобы использовать диапазон по умолчанию. date_to: type: string format: date example: '2026-03-31' description: >- Конец диапазона дат (ISO 8601, ГГГГ-ММ-ДД). Должен быть равен `date_from` или позже. 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 ````