メインコンテンツへスキップ
POST
/
companies
/
advertisements
/
search
企業広告検索
curl --request POST \
  --url https://api.pubrio.com/companies/advertisements/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "search_terms": [
    "pubrio"
  ],
  "headlines": [
    "ASUS",
    "iPhone"
  ],
  "filter_conditions": [
    {
      "key": "exclude_target_locations",
      "operator": "or"
    }
  ],
  "start_dates": [
    "2025-12-01",
    "2025-12-01"
  ],
  "end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "is_realtime_enrichment": true,
  "source_types": [
    "linkedin",
    "facebook"
  ],
  "enrichment_mode": "latest",
  "per_page": 25,
  "page": 1,
  "profile_id": 123
}
'
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 694356,
      "total_pages": 27775,
      "total_display_pages": 250,
      "is_timeout": false
    },
    "advertisements": [
      {
        "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"
        }
      },
      "..."
    ]
  }
}

承認

​
pubrio-api-key
string
header
必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの 設定 画面から発行できます。

ボディ

application/json
​
target_locations
string[]

国コードで特定の場所をターゲットにしている広告をフィルタリングします。特定の国で表示されている広告を検索します。filter_conditions と OR 演算子で組み合わせて使用します - 広告は指定された場所のうち少なくとも 1 つをターゲットにしている必要があります。

例:
["TW", "AE", "NO"]
​
exclude_target_locations
string[]

国コードで特定の場所をターゲットにしている広告を除外します。特定の国で表示されている広告をフィルタリング除外します。filter_conditions で演算子 'or' とともに指定された場合、広告は除外された場所のどれもターゲットにしていない必要があります。

例:
["IS", "GB", "FR", "IE", "ES"]
​
search_terms
string[]

検索結果を絞り込むために使用するキーワード文字列のリストです。

例:
["pubrio"]
​
headlines
string[]

検索結果をフィルタリングするためのヘッドラインのリストです。

例:
["ASUS", "iPhone"]
​
filter_conditions
object[]

広告検索の高度なフィルタリングオプションです。広告検索エンドポイントの検索結果を調整するための条件を指定します。

​
start_dates
string<date>[]

検索結果をフィルタリングするための開始日付のリストです。

例:
["2025-12-01", "2025-12-01"]
​
end_dates
string<date>[]

検索結果をフィルタリングするための終了日付のリストです。

例:
["2025-12-25", "2025-12-25"]
​
company_locations
string[]

企業本社の所在地を示すフィルターです。

例:
["US", "SG", "CN"]
​
companies
string<uuid>[]

企業および人物検索処理で利用する domain_search_id の一覧です。

​
domains
string[]

企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。

例:
["pubrio.com"]
​
linkedin_urls
string[]

企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。

例:
["https://www.linkedin.com/company/pubrio"]
​
is_realtime_enrichment
boolean
デフォルト:false

単一企業スコープのクエリ（domain_search_id、domains、または linkedin_urls でフィルタリング）でリアルタイムエンリッチメントを有効化します。初回検索が 0 件の場合、エンドポイントはソースをスクレイプし、レコードを保存したうえで検索を再実行してから応答します。ルートごとのデッドラインの対象です。

例:

true

​
source_types
enum<string>[]

リアルタイムエンリッチメントの対象とする広告ソースタイプを制限します。省略した場合はすべてのソースが対象です。リアルタイムエンリッチメントが実際に実行される場合にのみ適用されます。すなわち、is_realtime_enrichment または enrichment_mode: latest が設定されている場合です。

利用可能なオプション:
linkedin,
facebook,
google
例:
["linkedin", "facebook"]
​
enrichment_mode
enum<string>
デフォルト:default

リアルタイムエンリッチメントの動作を制御します。default はデータベースにすでに存在するデータを返し、結果が空で is_realtime_enrichment が設定されている場合にのみエンリッチメントを実行します。latest はキャッシュをバイパスし、呼び出しごとに最新のソースレコードに対する再エンリッチメントを強制します。他のフラグが設定されていなくても、latest 自体が単独でエンリッチメントを起動します。

利用可能なオプション:
default,
latest
例:

"latest"

​
per_page
integer

1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。

例:

25

​
page
integer

取得したい結果セットのページ番号です。

例:

1

​
profile_id
integer

オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。

レスポンス

企業の広告検索詳細情報を含む成功レスポンスです。

​
data
object

エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。