> ## 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. # 企業広告検索 > 指定した条件に一致する企業の広告を検索します。 `facebook` 広告の場合、`source_type` は Meta 広告ライブラリ全体（Facebook、Instagram、Messenger、Threads、Audience Network）を対象とし、`publisher_platforms` で配置面ごとに絞り込めます。`destination_url` は解決済みのランディングページを返します（`fb.me` などの Facebook クリックラッパーは実際のファネル URL に展開されます）。`raw_link_url` は取得時の元のリンクをそのまま保持します。 ## OpenAPI ````yaml jp-openapi POST /companies/advertisements/search openapi: 3.0.0 info: description: >- Pubrio API はマーケット拡大インテリジェンスを提供します——企業の新市場参入を捉えるリアルタイムシグナルと、その基盤となる企業・人物データ。アカウントやコンタクトの検索・ルックアップ・エンリッチメントに加え、200+ 市場にわたる種別・日付付きの動きシグナルを購読できます。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ja/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ja/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: LinkedInプロフィールURLから人物・企業データを検索 - name: Redeem description: クレジットを消費して人物の連絡先情報をアンロック（単件・バッチ） - name: Channels description: アウトリーチチャネルテンプレートの管理（作成・更新・削除・一覧） - name: Monitor description: Webhook、統計、処理を含むデータモニターの作成と管理 - name: Filters description: 検索パラメータで使用可能なフィルター値を取得（テクノロジー、地域、バーティカルなど） - name: API Keys description: APIキーのリクエストログと使用状況分析を表示 - name: Insights description: 企業のシグナル集計インサイト(採用、ニュース、広告)。 - name: Export description: 一括データエクスポート(クレジット消費)。 - name: Expansion description: '企業の市場拡大インテリジェンス: シグナル、ステージ、市場、エクスポート。' externalDocs: description: >- Pubrio API は、コンタクトおよびアカウント情報の検索・プレビュー・エンリッチメントに利用できます。Pubrio データベースは、豊富な B2B 連絡先データとセールスインテリジェンスを提供します。 url: https://docs.pubrio.com paths: /companies/advertisements/search: post: tags: - Search summary: 企業広告検索 description: >- 指定した条件に一致する企業の広告を検索します。 `facebook` 広告の場合、`source_type` は Meta 広告ライブラリ全体（Facebook、Instagram、Messenger、Threads、Audience Network）を対象とし、`publisher_platforms` で配置面ごとに絞り込めます。`destination_url` は解決済みのランディングページを返します（`fb.me` などの Facebook クリックラッパーは実際のファネル URL に展開されます）。`raw_link_url` は取得時の元のリンクをそのまま保持します。 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' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' source_types: $ref: '#/components/schemas/advertisement_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' profile_id: $ref: '#/components/schemas/profile_id' 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: data: $ref: '#/components/schemas/data' example: 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 - 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 - ... '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 演算子で組み合わせて使用します - 広告は指定された場所のうち少なくとも 1 つをターゲットにしている必要があります。 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: 検索結果をフィルタリングするための終了日付のリストです。 company_locations: type: array items: type: string example: - US - SG - CN description: 企業本社の所在地を示すフィルターです。 companies: type: array items: type: string format: uuid description: 企業および人物検索処理で利用する `domain_search_id` の一覧です。 domains: type: array items: type: string example: - pubrio.com description: 企業および人物検索に使用する会社ドメインの一覧です。`www` や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。 company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- 企業の LinkedIn 公式ページを指す完全な URL です。値は `http` で始まり、`linkedin.com/company/` を含んでいる必要があります。 is_realtime_enrichment: type: boolean default: false example: true description: >- 単一企業スコープのクエリ（`domain_search_id`、`domains`、または `linkedin_urls` でフィルタリング）でリアルタイムエンリッチメントを有効化します。初回検索が 0 件の場合、エンドポイントはソースをスクレイプし、レコードを保存したうえで検索を再実行してから応答します。ルートごとのデッドラインの対象です。 advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google example: - linkedin - facebook description: >- リアルタイムエンリッチメントの対象とする広告ソースタイプを制限します。省略した場合はすべてのソースが対象です。リアルタイムエンリッチメントが実際に実行される場合にのみ適用されます。すなわち、`is_realtime_enrichment` または `enrichment_mode: latest` が設定されている場合です。 advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- リアルタイムエンリッチメントの動作を制御します。`default` はデータベースにすでに存在するデータを返し、結果が空で `is_realtime_enrichment` が設定されている場合にのみエンリッチメントを実行します。`latest` はキャッシュをバイパスし、呼び出しごとに最新のソースレコードに対する再エンリッチメントを強制します。他のフラグが設定されていなくても、`latest` 自体が単独でエンリッチメントを起動します。 per_page: type: integer example: 25 description: 1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。 page: type: integer example: 1 description: 取得したい結果セットのページ番号です。 profile_id: type: integer description: >- オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。 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 で、企業に紐づく広告のみを返します。 data: type: object nullable: true description: エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。 responses: general_error: description: リクエストエラー。リクエストの形式が不正であるか、無効なパラメータが含まれています。エラーコードとメッセージを確認してください。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。 type: string details: type: object rate_limit_error: description: レート制限超過。一定期間内に多すぎるリクエストが送信されました。レート制限ウィンドウがリセットされた後に再試行してください。 content: application/json: schema: required: - error type: object properties: error: example: クライアントはしばらく待ってから再試行することが推奨されます。 type: string server_error: description: 内部サーバーエラー。サーバーで予期しないエラーが発生しました。エラーが続く場合はサポートにお問い合わせください。 content: application/json: schema: required: - error type: object properties: error: example: レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの [設定](https://dashboard.pubrio.com/#/settings/) 画面から発行できます。 in: header ````