広告検索

広告検索は Pubrio が取得した個々の広告を 1 件 1 行で返します。各行にはクリエイティブ（見出し、画像または動画、ランディングページ）、表示された地域、配信期間、ソースが報告するインプレッション範囲が含まれます。

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_* メトリクスフィルターで、支出額なしに広告量で企業をランク付けできます。

合計やトレンドには広告インサイトを使ってください。広告そのものではなく、広告活動から企業を探す場合は企業検索の 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`。フォーマットを参照。
`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（取得日時）の新しい順です。

行の例

{
  "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`

"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` に適用されなかったソース

レシピ

ある市場の競合クリエイティブ
高リーチの LinkedIn 広告
Instagram のみの Meta 広告

cURL

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
  }'

cURL

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 で大きく出稿している企業です。

cURL

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 社の期間内の合計、リーチ帯域、クリエイティブ。

広告アクティビティフィルター

企業検索で広告活動から企業を探す。

列挙値と定数

ソース、フォーマット、プラットフォーム、リーチ帯域。

モニター

検索

フィルター

人物

拡大

使いどころ

ソース

企業で絞り込む

フィルター

ソースとフォーマット

テキスト

日付

表示された地域

リーチと量

エンリッチメント

ページングと並び順

行の例

このエンドポイントの `metadata`

レシピ

関連

広告検索リファレンス

広告インサイト

広告アクティビティフィルター

列挙値と定数

​使いどころ

​ソース

​企業で絞り込む

​フィルター

​ソースとフォーマット

​テキスト

​日付

​表示された地域

​リーチと量

​エンリッチメント

​ページングと並び順

​行の例

​このエンドポイントの metadata

​レシピ

​関連

広告検索リファレンス

広告インサイト

広告アクティビティフィルター

列挙値と定数

使いどころ

ソース

企業で絞り込む

フィルター

ソースとフォーマット

テキスト

日付

表示された地域

リーチと量

エンリッチメント

ページングと並び順

行の例

このエンドポイントの `metadata`

レシピ

関連