> ## 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. # 広告検索 > LinkedIn、Meta、Google、TikTok、Apple で企業が出稿している広告を、ソース、フォーマット、対象国、リーチ、配信期間で検索し、各広告のクリエイティブ、ランディングページ、インプレッションデータを読み取ります。 [広告検索](/jp/api-reference/endpoint/companies/advertisements_search)は Pubrio が取得した個々の広告を 1 件 1 行で返します。各行にはクリエイティブ（見出し、画像または動画、ランディングページ）、表示された地域、配信期間、ソースが報告するインプレッション範囲が含まれます。 ```bash theme={null} curl -X POST https://api.pubrio.com/companies/advertisements/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "domains": ["stripe.com"], "source_types": ["linkedin", "facebook"], "active_dates": ["2026-08-01", "2026-08-31"], "per_page": 25 }' ``` ## 使いどころ * **競合クリエイティブ調査** — 競合が何を、どの国で、どのフォーマットで訴求しているか。 * **インテント** — 新しい市場で広告を出し始めた企業は、その市場に進出しています。`target_locations` と組み合わせてください。 * **出稿量の代理指標** — `reach_tiers` と `advertisement_*` メトリクスフィルターで、支出額なしに広告量で企業をランク付けできます。 合計やトレンドには[広告インサイト](/jp/api-reference/endpoint/companies/advertisements_insights)を使ってください。広告そのものではなく、広告活動から*企業*を探す場合は[企業検索](/jp/api-reference/endpoint/companies/search)の `advertisement_*` フィルターを使ってください。 ## ソース | `source_type` | 備考 | | ------------- | ----------------------------------------------------------------------------------------------------------------- | | `linkedin` | 豊富なフォーマットラベル（`Single Image Ad`、`Document Ad` など） | | `facebook` | Facebook、Instagram、Messenger、Threads、Audience Network にまたがり、`publisher_platforms` で絞り込めます。`meta` はエイリアスとして受け付けます。 | | `google` | 大半が `text` | | `tiktok` | | | `apple` | | ソースが推定値を公開していない広告は `total_impressions` が `null` で、`reach_tiers` に一致しません。 ## 企業で絞り込む | キー | 値 | | --------------- | --------------------------------------------- | | `domains` | `["stripe.com"]` | | `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | | `companies` | `["5378845d-…"]` — `domain_search_id` の値 | 企業なしの検索も可能です。例：`{"target_locations": ["SG"], "source_types": ["linkedin"]}`。`is_include_unlinked_companies: true` を指定しない限り、Pubrio の企業にすでに紐づいている広告のみが返されます。 ## フィルター ### ソースとフォーマット | キー | 型 | 一致対象 | | ----------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `source_types` | `string[]` | `linkedin`、`facebook`、`google`、`tiktok`、`apple`。列挙したいずれか。未知の値は何にも一致せず `metadata.unsupported_source_types` にエコーされます。 | | `exclude_source_types` | `string[]` | 同じ語彙で除外。 | | `advertisement_formats` | `string[]` | 正規フォーマット：`image`、`video`、`text`、`carousel`、`dynamic_product`、`document`、`message`、`event`、`article`、`spotlight`、`follow`、`job`、`engagement`。[フォーマット](/jp/api-reference/enums#フォーマット)を参照。 | | `publisher_platforms` / `exclude_publisher_platforms` | `string[]` | `facebook`、`instagram`、`messenger`、`threads`、`audience_network`。Meta 広告のみ。 | ### テキスト | キー | 型 | 一致対象 | | ------------------------------ | --------------------- | ----------------- | | `headlines` | `string[]` | 見出しテキスト。列挙したいずれか。 | | `search_term` / `search_terms` | `string` / `string[]` | 見出しと説明文。 | ### 日付 | キー | 型 | 一致対象 | | -------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `active_dates` | `[from, to]` | ウィンドウ内の**いずれかの時点で配信中**だった広告。より前に開始してまだ配信中の広告も含みます。広告インサイトと同じウィンドウです。`started_at` のない広告は `created_at` から数えます。両方の日付が必須で、日付境界は UTC。 | | `start_dates` | `[from, to]` | `started_at` がウィンドウ内 — その期間に*開始*した広告。日付境界はワークスペースのタイムゾーン。 | | `end_dates` | `[from, to]` | `ended_at` がウィンドウ内。日付境界はワークスペースのタイムゾーン。 | | `created_at` | 日付または ISO タイムスタンプ | Pubrio がこの時刻以降に取得したもの（UTC）。増分同期用。 | `start_dates` は企業の配信中キャンペーンの大半を隠します。3 月に開始したキャンペーンは 8 月もまだ配信中だからです。開始した広告だけが必要な場合を除き、`active_dates` を使ってください。 ### 表示された地域 | キー | 型 | 一致対象 | | -------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------- | | `target_locations` | `string[]` | 広告が配信された国。デフォルトは OR。`filter_conditions` に `{"key": "target_locations", "operator": "and"}` を追加すると、すべての国を必須にできます。 | | `exclude_target_locations` | `string[]` | 除外する国。 | | `company_locations` | `string[]` | 広告主の本社所在国。 | ### リーチと量 | キー | 型 | 一致対象 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------- | | `reach_tiers` | `string[]` | 広告のインプレッション帯域：`lt_1k`、`1k_10k`、`10k_50k`、`50k_100k`、`100k_500k`、`500k_1m`、`1m_plus`。`total_impressions` のない広告は一致しません。 | | `advertisement_active_ads`、`advertisement_running_ads`、`advertisement_total_ads`、`advertisement_platform_count`、`advertisement_format_count`、`advertisement_impressions_estimate` | `[min, max]` | **広告主**の合計で広告を絞り込みます。例：`advertisement_active_ads: [10, null]` は配信中の広告が 10 件以上ある企業の広告を返します。 | | `advertisement_country_activity` | オブジェクト | `{ "country": "US", "rank": [null, 100] }` — その国の上位 100 広告主の広告。 | ### エンリッチメント | キー | 型 | 備考 | | ------------------------------- | -------------------- | ------------------------------------------------------------- | | `is_realtime_enrichment` | `boolean` | 検索結果がなければ、今すぐソースをスクレイピングして再検索します。企業で絞った検索のみ。 | | `enrichment_mode` | `default` / `latest` | `latest` はキャッシュに関係なく毎回再スクレイピングします。 | | `is_include_unlinked_companies` | `boolean` | Pubrio が企業レコードに紐づけられなかった広告（`is_company_matched: false`）も返します。 | ### ページングと並び順 `per_page`、`page`、`is_ascending_order` は他の検索と同じ挙動です。行は `created_at`（取得日時）の新しい順です。 ## 行の例 ```json theme={null} { "advertisement_id": "58fa840e-08aa-4ac8-a204-8b185fd62f8e", "advertisement_search_id": "58fa840e-08aa-4ac8-a204-8b185fd62f8e", "created_at": "2026-09-01T02:00:07.068Z", "last_modified": "2026-09-01T02:00:07.068Z", "started_at": "2026-08-24T00:00:00.000Z", "ended_at": "2026-08-31T00:00:00.000Z", "title": "Your 2026 peak season prep checklist is here", "source_type": "linkedin", "advertisement_format": "Single Image Ad", "advertisement_format_normalized": "image", "is_company_matched": true, "advertiser": "Stripe", "advertiser_url": "https://www.linkedin.com/company/2135371", "advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034", "total_impressions": "< 1k", "total_impressions_lower": null, "total_impressions_upper": 1000, "image_url": "https://buckets.pubrio.com/images/public/….jpg", "video_url": null, "carousel_images": null, "destination_url": "https://stripe.com/industries/retail?trk=…", "raw_link_url": null, "target_country_codes": ["US"], "publisher_platforms": null, "companies": { "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee", "company_name": "Stripe", "domain": "stripe.com", "country_code": "US", "…": "…" } } ``` * 広告が配信中の間、`ended_at` は `null` です。 * `advertisement_format` はソース独自のラベル、`advertisement_format_normalized` はフィルターに使えるスラッグです。 * `destination_url` は展開後のランディングページ、`raw_link_url` はクリックトラッカーを取得時のまま保持します。 * `total_impressions` はソースのテキスト、`_lower` / `_upper` はパース済みの範囲です。 ### このエンドポイントの `metadata` ```json theme={null} "metadata": { "profile": null, "filters": { "domains": ["stripe.com"], "source_types": ["tiktok", "bogus"], "per_page": 25, "language": "en" }, "ignored_fields": [], "applied_source_types": ["tiktok"], "unsupported_source_types": ["bogus"], "coverage_notes": [{ "source_type": "tiktok", "scope": "eea_uk_ch" }] } ``` | キー | 出現条件 | 意味 | | -------------------------- | ------------------ | ------------------------------------------------------------------------- | | `ignored_fields` | 常に | エンドポイントが破棄したボディキー | | `applied_source_types` | `source_types` を送信 | 認識された値 | | `unsupported_source_types` | 未知の値を送信 | それらの値は何にも一致しなかった | | `coverage_notes` | 該当する場合 | リクエストしたソースのカバレッジ情報 | | `skipped_source_types` | 該当する場合 | `[{ "source_type", "reason" }]` — リクエストした `target_locations` に適用されなかったソース | ## レシピ ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/advertisements/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "domains": ["adyen.com", "checkout.com"], "target_locations": ["SG", "AU"], "advertisement_formats": ["video", "carousel"], "active_dates": ["2026-08-01", "2026-09-04"], "per_page": 25 }' ``` ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/advertisements/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "target_locations": ["US"], "source_types": ["linkedin"], "reach_tiers": ["100k_500k", "500k_1m", "1m_plus"], "active_dates": ["2026-08-01", "2026-09-04"], "per_page": 25 }' ``` 各行の `companies.domain_search_id` は、今月米国の LinkedIn で大きく出稿している企業です。 ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/advertisements/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "domains": ["nike.com"], "source_types": ["facebook"], "publisher_platforms": ["instagram"], "exclude_publisher_platforms": ["facebook"], "per_page": 25 }' ``` ## 関連 すべてのパラメーターとレスポンスフィールド。 1 社の期間内の合計、リーチ帯域、クリエイティブ。 企業検索で広告活動から企業を探す。 ソース、フォーマット、プラットフォーム、リーチ帯域。