> ## 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/advertisement-search). ## OpenAPI ````yaml ru-openapi POST /companies/advertisements/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/advertisements/search: post: tags: - Search summary: Поиск рекламы компаний description: >- Поиск рекламы, размещённой компаниями. См. [руководство по поиску рекламы](/en/developer-guides/search/advertisement-search). operationId: companies_search_advertisements parameters: [] requestBody: required: true content: application/json: schema: type: object properties: target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' search_terms: $ref: '#/components/schemas/search_terms' headlines: $ref: '#/components/schemas/headlines' filter_conditions: $ref: '#/components/schemas/ads_filter_conditions' start_dates: $ref: '#/components/schemas/start_dates' end_dates: $ref: '#/components/schemas/end_dates' active_dates: $ref: '#/components/schemas/advertisement_active_dates_search' created_at: $ref: '#/components/schemas/search_created_at' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' advertisement_search_id: allOf: - $ref: '#/components/schemas/advertisement_search_id' description: >- Вернуть только эту одну запись. Удобно для повторного получения ранее сохранённой строки без постраничной навигации. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' advertisement_formats: $ref: '#/components/schemas/advertisement_formats' reach_tiers: $ref: '#/components/schemas/advertisement_reach_tiers' advertisement_active_ads: $ref: '#/components/schemas/advertisement_active_ads' advertisement_running_ads: $ref: '#/components/schemas/advertisement_running_ads' advertisement_total_ads: $ref: '#/components/schemas/advertisement_total_ads' advertisement_platform_count: $ref: '#/components/schemas/advertisement_platform_count' advertisement_format_count: $ref: '#/components/schemas/advertisement_format_count' advertisement_impressions_estimate: $ref: '#/components/schemas/advertisement_impressions_estimate' advertisement_country_activity: $ref: '#/components/schemas/advertisement_country_activity' source_types: $ref: '#/components/schemas/advertisement_source_types' exclude_source_types: $ref: '#/components/schemas/advertisement_exclude_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms is_include_unlinked_companies: $ref: >- #/components/schemas/advertisement_is_include_unlinked_companies responses: '200': description: Успешный ответ с данными поиска рекламы компании. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/advertisement_search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' advertisements: type: array items: $ref: '#/components/schemas/advertisement_search_result' example: metadata: profile: null filters: source_types: - linkedin per_page: 25 language: en ignored_fields: [] applied_source_types: - linkedin data: pagination: page: 1 per_page: 25 total_entries: 694356 total_pages: 27775 total_display_pages: 250 is_timeout: false advertisements: - target_country_codes: - US - GB - SG advertisement_id: 3af8cb80-9a04-49a8-832d-333961d5f77a advertisement_search_id: 3af8cb80-9a04-49a8-832d-333961d5f77a created_at: '2026-03-03T01:46:35.909Z' last_modified: '2026-03-03T12:46:25.289Z' started_at: '2026-02-25T00:00:00.000Z' ended_at: '2026-03-02T00:00:00.000Z' title: Thuraya-4 Satellite Solutions for Energy source_type: linkedin advertisement_format: Single Image Ad video_url: null image_url: >- https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg carousel_images: null destination_url: >- https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg domain_search_id: fe3963dc-87a4-4016-8c95-217ea68cd57a company_name: Space42 linkedin_name: space42ai country_code: AE domain: space42.ai raw_link_url: null publisher_platforms: null advertisement_format_normalized: image is_company_matched: true advertiser: Thuraya advertiser_url: https://www.linkedin.com/company/thuraya advertisement_url: https://www.linkedin.com/ad-library/detail/1518455034 total_impressions: < 1k total_impressions_lower: null total_impressions_upper: 1000 - target_country_codes: - US - GB - SG advertisement_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 advertisement_search_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 created_at: '2026-06-03T22:00:33.035Z' last_modified: '2026-06-05T18:15:51.823Z' started_at: '2026-05-25T07:00:00.000Z' ended_at: '2026-06-03T07:00:00.000Z' title: Dubai Opportunities. One Exclusive Event source_type: facebook advertisement_format: DCO video_url: null image_url: >- https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg carousel_images: null destination_url: >- https://promotions.damacproperties.com/en/event-in-egypt-social-specific/ raw_link_url: http://fb.me/ publisher_platforms: - facebook - instagram companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 9da7386c-5bdc-42b2-8fee-456e91024a3a company_name: Damac Properties linkedin_name: damac-properties country_code: AE domain: damacproperties.com advertisement_format_normalized: image is_company_matched: true advertiser: Thuraya advertiser_url: https://www.linkedin.com/company/thuraya advertisement_url: https://www.linkedin.com/ad-library/detail/1518455034 total_impressions: < 1k total_impressions_lower: null total_impressions_upper: 1000 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Фильтр рекламы для включения объявлений, нацеленных на конкретные местоположения, по коду страны. Используйте это, чтобы найти рекламу, показываемую в конкретных странах. Сочетается с `filter_conditions` через оператор OR — реклама должна быть нацелена хотя бы на одно из указанных местоположений. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Фильтр рекламы для исключения объявлений, нацеленных на конкретные местоположения, по коду страны. Используйте это, чтобы отфильтровать рекламу, показываемую в конкретных странах. При указании в `filter_conditions` с оператором 'or' реклама не должна быть нацелена ни на одно из исключённых местоположений. search_terms: type: array items: type: string example: - pubrio description: Список строк, по которым мы фильтруем результаты. headlines: type: array items: type: string example: - ASUS - iPhone description: Список заголовков для фильтрации результатов поиска. ads_filter_conditions: type: array items: type: object properties: key: type: string enum: - target_locations - exclude_target_locations example: exclude_target_locations description: >- Ключ фильтра, определяющий, к какому свойству применяется оператор. operator: type: string enum: - or - and example: or description: >- Логический оператор для применения. Используйте 'or' для сопоставления рекламы, включающей/исключающей любое из указанных местоположений, или 'and' для сопоставления рекламы, включающей/исключающей все указанные местоположения. description: >- Расширенные параметры фильтрации для поиска рекламы. Задайте условия, чтобы уточнить результаты поиска для эндпоинта поиска рекламы. start_dates: type: array items: type: string format: date example: - '2025-12-01' - '2025-12-01' description: Список начальных дат для фильтрации результатов поиска. end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Список конечных дат для фильтрации результатов поиска. advertisement_active_dates_search: type: array items: type: string format: date minItems: 2 maxItems: 2 example: - '2026-08-01' - '2026-08-31' description: >- Включающий диапазон `[from, to]` (UTC). Возвращает рекламу, показывавшуюся в любой момент в этом диапазоне, включая начавшуюся ранее, поэтому согласуется с Advertisement Insights. Реклама без даты учитывается по `created_at`. Обе даты обязательны, `from` ≤ `to`. search_created_at: type: string format: date-time example: '2026-09-02T12:00:00Z' description: >- Загружено в этот момент времени (UTC) или позже. Дата или временная метка ISO. Для инкрементальной синхронизации передайте `created_at` вашей самой новой сохранённой строки. 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), используемых для операций поиска компаний и людей. advertisement_search_id: type: string format: uuid example: a92643e8-9033-4029-aa65-ef929327cebb 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/` is_realtime_enrichment: type: boolean default: false example: true description: >- Включить обогащение в реальном времени для одного запроса в рамках конкретной компании (отфильтрованного по `domain_search_id`, `domains` или `linkedin_urls`). Если первоначальный поиск не возвращает результатов, эндпоинт извлекает данные из источника, сохраняет записи и повторно выполняет поиск перед формированием ответа. Действует ограничение по времени для каждого маршрута. advertisement_formats: type: array items: type: string enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement example: - image - video description: >- Найти компании, у которых есть хотя бы одна реклама в любом из этих креативных форматов. advertisement_reach_tiers: type: array items: type: string enum: - lt_1k - 1k_10k - 10k_50k - 50k_100k - 100k_500k - 500k_1m - 1m_plus example: - 100k_500k - 500k_1m - 1m_plus description: >- Диапазон показов рекламы: `lt_1k`, `1k_10k`, `10k_50k`, `50k_100k`, `100k_500k`, `500k_1m`, `1m_plus`. Реклама без значения `total_impressions` никогда не совпадает; неизвестные слаги ничего не находят. advertisement_active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимальное и максимальное количество текущих активных объявлений компании по всем странам. Используйте `null` для открытой границы, например `[1, null]` для «хотя бы одно активное объявление». advertisement_running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимальное и максимальное количество объявлений компании, которые всё ещё показываются (без даты окончания или с датой окончания в будущем). В настоящее время заполняется только для рекламы LinkedIn. advertisement_total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Минимальное и максимальное количество всех объявлений компании, когда-либо зафиксированных, по всем странам. advertisement_platform_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Минимальное и максимальное количество уникальных рекламных платформ (linkedin, facebook, google, tiktok, apple), на которых компания активно размещает рекламу. advertisement_format_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Минимальное и максимальное количество уникальных креативных форматов рекламы, которые компания активно использует. advertisement_impressions_estimate: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- Минимальное и максимальное расчётное количество показов рекламы, суммированное по всем странам. Учитываются только объявления с указанным диапазоном показов. advertisement_country_activity: type: object properties: country: type: string example: US description: >- Код страны ISO 3166-1 alpha-2, к которому нужно ограничить этот фильтр. Обязательно. rank: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - null - 500 description: >- Ранг в этой стране по объёму рекламы. 1 — крупнейший рекламодатель, число увеличивается по мере снижения объёма рекламы. Используйте `[null, 500]`, чтобы найти 500 крупнейших рекламодателей в этой стране; используйте `[500, null]`, чтобы найти всех, кто занимает 500-е место или ниже. percentile: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 90 - null description: >- Процентиль в этой стране по объёму рекламы, от 0 до 100. Чем выше, тем крупнее рекламодатель. Используйте `[90, null]` для топ-10% рекламодателей в этой стране. volume_score: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 0.5 - null description: >- Базовая оценка объёма рекламы по шкале от 0 до 1, на основе которой вычисляются `rank` и `percentile`. active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимальное и максимальное количество активных объявлений, ограниченное этой страной. running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Минимальное и максимальное количество показываемых объявлений, ограниченное этой страной. В настоящее время заполняется только для рекламы LinkedIn. total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Минимальное и максимальное количество всех объявлений, ограниченное этой страной. impressions: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- Минимальное и максимальное расчётное количество показов, ограниченное этой страной. required: - country example: country: US rank: - null - 500 description: >- Рекламная активность для одной конкретной страны. Поле `country` обязательно, и должно быть задано хотя бы одно другое поле (сама по себе страна ничего не находит). Для общего итога по всем странам используйте вместо этого фильтры верхнего уровня `advertisement_active_ads` / `advertisement_total_ads` / `advertisement_impressions_estimate`. advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - linkedin - facebook description: >- Источники для включения: `linkedin`, `facebook` (принимается `meta`), `google`, `tiktok`, `apple`. Неизвестные значения не находят ничего и отражаются в `metadata.unsupported_source_types`. advertisement_exclude_source_types: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - apple description: >- Исключить рекламу, полученную из этих источников. Тот же словарь, что и `source_types` (`linkedin`, `facebook`, `google`, `tiktok`, `apple`; `meta` — псевдоним для `facebook`). Неизвестные значения игнорируются. advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- Управляет поведением обогащения в реальном времени. `default` возвращает то, что уже есть в базе данных, и запускает обогащение только если набор результатов пуст и указан `is_realtime_enrichment`. `latest` обходит кэш и принудительно запускает повторное обогащение по самым свежим исходным записям при каждом вызове — он запускает обогащение самостоятельно, без необходимости в других флагах. 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` — ключ сортировки фиксирован и указан в описании эндпоинта. advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: >- Фильтр рекламы Facebook/Meta по платформе показа. В нижнем регистре, без учёта регистра. Применяется только к источнику `facebook` (остальные источники относятся к одной платформе). advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: Исключить рекламу Facebook/Meta, показанную на этих платформах. advertisement_is_include_unlinked_companies: type: boolean default: false example: true description: >- Включить рекламу, ещё не связанную с определённой компанией (реклама необработанного слоя, например мошенническая реклама или реклама фиктивных страниц). По умолчанию false, что возвращает только рекламу, связанную с компанией. advertisement_search_metadata: allOf: - $ref: '#/components/schemas/search_metadata' - type: object properties: applied_source_types: type: array items: type: string description: >- Только если был передан `source_types`: значения, которые были распознаны и применены. unsupported_source_types: type: array items: type: string description: >- Только если `source_types` содержал значение, не являющееся известным источником. Такие значения ничего не находят. coverage_notes: type: array items: type: object properties: source_type: type: string scope: type: string enum: - eea_uk_ch description: Примечания об охвате для запрошенных источников, если применимо. skipped_source_types: type: array items: type: object properties: source_type: type: string description: Пропущенный источник. reason: type: string enum: - country_unknown_until_enriched description: Почему источник не был применён. description: >- Источники, не применённые для запрошенных `target_locations`, каждый с указанием `reason`. 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` является приблизительной оценкой. advertisement_search_result: type: object description: Одна реклама. properties: advertisement_id: type: string format: uuid description: Идентификатор рекламы. advertisement_search_id: type: string format: uuid description: >- То же значение, что и `advertisement_id`. Передайте его в Advertisement Lookup. created_at: type: string format: date-time description: >- Когда Pubrio впервые зафиксировал рекламу. Это ключ сортировки по умолчанию. last_modified: type: string format: date-time description: Когда запись была последний раз обновлена. started_at: type: string format: date-time description: Когда реклама начала показываться, по данным источника. nullable: true ended_at: type: string format: date-time description: >- Когда реклама перестала показываться; `null`, пока она всё ещё показывается. nullable: true title: type: string description: Заголовок или название рекламы. nullable: true source_type: type: string enum: - linkedin - facebook - google - tiktok - apple description: >- Источник, из которого получена реклама. Тот же словарь, что и фильтр `source_types`. advertisement_format: type: string description: >- Метка формата в точности так, как её публикует источник, например `Single Image Ad`, `MULTI_IMAGES`. nullable: true advertisement_format_normalized: type: string nullable: true enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement - other description: >- Канонический формат, словарь, который принимает фильтр `advertisement_formats`. `other`, если исходная метка не сопоставлена. is_company_matched: type: boolean description: >- `true`, если реклама связана с записью компании в Pubrio. Несвязанная реклама возвращается только при `is_include_unlinked_companies: true`. advertiser: type: string description: Название рекламодателя, как указано источником. nullable: true advertiser_url: type: string description: Страница рекламодателя у источника, если доступна. nullable: true advertisement_url: type: string description: Ссылка на рекламу в библиотеке рекламы источника, если доступна. nullable: true total_impressions: type: string description: >- Оценка показов в точности так, как её публикует источник, например `< 1k`, `10k-50k`. `null` для источников, не сообщающих о показах. nullable: true total_impressions_lower: type: integer nullable: true description: Нижняя граница диапазона показов; `null` для диапазонов вида `< N`. total_impressions_upper: type: integer nullable: true description: Верхняя граница диапазона показов; `null` для открытых диапазонов. image_url: type: string description: Изображение креатива, если у рекламы оно есть. nullable: true video_url: type: string description: Видео креатива, если у рекламы оно есть. nullable: true carousel_images: type: array nullable: true items: type: string description: Кадры карусели для карусельных форматов. destination_url: type: string description: >- Разрешённая целевая страница. Обёртки переходов Facebook, такие как `fb.me`, разворачиваются в реальный URL воронки. nullable: true raw_link_url: type: string description: >- Исходная ссылка в точности так, как она была получена, до разворачивания. nullable: true target_country_codes: type: array nullable: true items: type: string description: >- Страны, в которых показывалась реклама (ISO 3166-1 alpha-2). Тот же словарь, что и фильтр `target_locations`. publisher_platforms: type: array nullable: true items: type: string enum: - facebook - instagram - messenger - threads - audience_network description: >- Платформы Meta, на которых показывалась реклама: `facebook`, `instagram`, `messenger`, `threads`, `audience_network`. `null` для источников, отличных от `facebook`. companies: $ref: '#/components/schemas/search_result_company' 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_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 ````