AND / OR 演算子

filter_conditions はリクエストボディ上のオプションの配列です。各要素は、1 つの複数値フィルターをデフォルトの OR(「いずれかにマッチ」)から AND(「すべてにマッチ」)へ、あるいはその逆へと切り替えます。記載されていないフィルターはデフォルトのままです。

スキーマ

{
  "filter_conditions": [
    { "key": "technologies", "operator": "and" },
    { "key": "verticals",    "operator": "or"  }
  ]
}

type FilterCondition = {
  /** 上書きするフィルター名。下記「サポートされるキー」を参照。 */
  key: string;
  /** 大文字小文字を区別しない: "and" | "or"。配列のデフォルトは "or"。 */
  operator: "and" | "or";
};

type SearchRequest = {
  // …他のすべてのフィルター…
  filter_conditions?: FilterCondition[];
};

各要素の key と operator はどちらも必須です。operator のみのエントリは黙って無視されます — グローバルなオーバーライド設定はありません。

なぜ重要か

デフォルト演算子が OR なのは、多くのプロスペクティングが広い再現を求めるためです: 「いずれかの国の人物」「いずれかのバーティカルがタグ付けされた企業」。一方で、高精度のターゲティング — 「Salesforce + HubSpot + Marketo を すべて 使う」 — には AND が必要です。選択を誤ったときのコスト:

AND が欲しかったのに OR: 過剰再現になり、1 タグだけマッチした企業まで含まれてしまう。気づきやすいが結果品質を損ないます。
OR が欲しかったのに AND: 再現不足になり、複数値の AND は実世界の配列にすべての要求値が揃わないため、ほぼ 0 行になることが多い。気づきやすく、クエリが壊れて見えます。

サポートされるキー

正確なキーセットは呼び出すエンドポイントによります:

キー	`/companies/search`	`/people/search`	`/companies/advertisements/search`	`/companies/cloud_footprints/search`	デフォルト	`and` の意味
`technologies`	✓	✓	—	—	OR	リストの全テクノロジーを保有
`categories`	✓	✓	—	—	OR	全カテゴリでタグ付け
`verticals`	✓	✓	—	—	OR	全バーティカルに属する
`vertical_categories`	✓	✓	—	—	OR	全バーティカルカテゴリに属する
`vertical_sub_categories`	✓	✓	—	—	OR	全サブカテゴリに属する
`keywords`	✓	✓	—	—	OR	説明が全キーワードを含む
`social_media`	✓	✓	—	—	OR	列挙した全ネットワークにプロフィールを保有
`advertisement_target_locations`	✓	—	—	—	OR	広告が全国を対象(企業エンドポイント)
`job_exclude_locations`	✓	—	—	—	OR	求人が全ロケーションを除外
`target_locations`	—	—	✓	—	OR	広告が全国を対象(広告エンドポイント)
`publisher_platforms`	—	—	✓	—	OR	広告が列挙した全プラットフォームで配信
`cloud_regions`	—	—	—	✓	OR	列挙した全クラウドリージョンで稼働
`cities`	—	—	—	✓	OR	列挙した全都市で稼働

場所フィルター(places、exclude_places)、その他の exclude_* フィルター、および advertisement_search_terms は、常に列挙した値のいずれかにマッチします。求人検索とニュース検索は filter_conditions を受け付けず、リストフィルターは常に列挙した値のいずれかにマッチします。

上記のキーは OpenAPI 各 *_filter_conditions スキーマの enum(company_filter_conditions、people_filter_conditions、ads_filter_conditions、cloud_footprint_filter_conditions)を反映しています。エンドポイントが対応しないキーを送っても黙って無視されます。

レシピ

全テクノロジーを保有(企業)
いずれかのロケーション + 除外
マルチリージョン広告キャンペーン
複数スタック企業の人物

目標: Salesforce と HubSpot を両方使っている企業 — 片方だけではなく。

curl -X POST https://api.pubrio.com/companies/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "technologies": [10191, 121],
        "filter_conditions": [
            { "key": "technologies", "operator": "and" }
        ],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    technologies: [10191, 121],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

filter_conditions の要素を外せば、2 つの どちらか を含む検索に拡張されます。

目標: US・CA・GB の いずれか に所在し、サンフランシスコは除外する企業。locations のデフォルトは既に OR なので、明示する必要はありません。exclude_places は独立したネガティブフィルター — オーバーライドも不要。

curl -X POST https://api.pubrio.com/companies/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "locations": ["US", "CA", "GB"],
    "exclude_places": ["San Francisco"],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "locations": ["US", "CA", "GB"],
        "exclude_places": ["San Francisco"],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    locations: ["US", "CA", "GB"],
    exclude_places: ["San Francisco"],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

目標: EU と US の両方を対象とする広告(マルチリージョンキャンペーン) — 単一市場の広告ではなく。専用の ads_filter_conditions スキーマで target_locations キーを使います。

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "target_locations": ["US", "DE", "FR"],
    "filter_conditions": [
      { "key": "target_locations", "operator": "and" }
    ],
    "start_dates": ["2026-01-01"],
    "end_dates":   ["2026-04-22"],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/companies/advertisements/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "target_locations": ["US", "DE", "FR"],
        "filter_conditions": [
            { "key": "target_locations", "operator": "and" }
        ],
        "start_dates": ["2026-01-01"],
        "end_dates":   ["2026-04-22"],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/companies/advertisements/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    target_locations: ["US", "DE", "FR"],
    filter_conditions: [
      { key: "target_locations", operator: "and" }
    ],
    start_dates: ["2026-01-01"],
    end_dates:   ["2026-04-22"],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

広告エンドポイントは独自の ads_filter_conditions スキーマ(キーセットが小さい: target_locations、publisher_platforms)を使います。/companies/search や /people/search で使えるオーバーライドキーはここでは適用 されません。

目標: Salesforce と HubSpot を両方導入している企業の人物 — 古典的な CRM リプレイス信号。同じ technologies キーと演算子を /people/search で使う、統一エンジンの実例です。

curl -X POST https://api.pubrio.com/people/search \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "people_titles": ["RevOps", "Sales Operations"],
    "technologies": [10191, 121],
    "filter_conditions": [
      { "key": "technologies", "operator": "and" }
    ],
    "per_page": 25,
    "page": 1
  }'

import requests

response = requests.post(
    "https://api.pubrio.com/people/search",
    headers={
        "Content-Type": "application/json",
        "pubrio-api-key": "YOUR_API_KEY",
    },
    json={
        "people_titles": ["RevOps", "Sales Operations"],
        "technologies": [10191, 121],
        "filter_conditions": [
            { "key": "technologies", "operator": "and" }
        ],
        "per_page": 25,
        "page": 1,
    },
)
print(response.json())

const response = await fetch("https://api.pubrio.com/people/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "pubrio-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    people_titles: ["RevOps", "Sales Operations"],
    technologies: [10191, 121],
    filter_conditions: [
      { key: "technologies", operator: "and" }
    ],
    per_page: 25,
    page: 1,
  }),
});
console.log(await response.json());

よくある間違い

key を忘れて operator だけ送る

グローバルな「デフォルト演算子」スイッチはありません。各エントリは具体的なフィルターを指定する必要があります:

// 無視される — key がない
{ "filter_conditions": [{ "operator": "and" }] }

// 正しい — technologies フィルターだけを上書き
{ "filter_conditions": [{ "key": "technologies", "operator": "and" }] }

エントリが組み合わさると思い込む

エントリはキーごとに独立した上書きで、相互に連鎖しません。technologies と verticals を両方並べても、両者の間にブール式は構築されません。各々が自分の配列の演算子を設定するだけです。フィルターキー間 の組み合わせは常に AND(全フィルターがマッチする必要)です。filter_conditions で異なるフィルター次元を OR 結合することはできません。本当に「異なるフィルターの OR」検索が必要なら、2 回リクエストを投げてクライアント側でマージしてください。

長い配列で AND を使う

AND は列挙したすべての値が存在することを要求します。8 件以上になるとほぼ常に 0 行になります。実世界のタグ付けは疎なため。AND オーバーライドの配列は 2〜4 値に抑え、探索的・カテゴリレベルのフィルタリングは OR で。

ロケーションまたは場所フィルターで AND を使う

ロケーションと場所のフィルター(locations、places、およびその company_ 付き・exclude_ 付きの形式)は、常に列挙した値のいずれかにマッチします。これらに対する filter_conditions のエントリは無視されます。

迷ったら、まず filter_conditions を省略して結果件数を期待値と照合してください。デフォルトが意図に合わないフィルターにだけオーバーライドを追加する — リクエストペイロードが小さく、デバッグも楽になります。

フィルター概要

メンタルモデル — filter_conditions が初めての方はここから。

人物 + 企業フィルター

/people/search に企業フィルターを重ねる方法、キー再マッピングを含む。

企業検索リファレンス

/companies/search の完全なリクエストスキーマ(company_filter_conditions 含む)。

人物検索リファレンス

/people/search の完全なリクエストスキーマ(people_filter_conditions 含む)。

モニター

検索

フィルター

人物

拡大

スキーマ

なぜ重要か

サポートされるキー

レシピ

よくある間違い

関連項目

フィルター概要

人物 + 企業フィルター

企業検索リファレンス

人物検索リファレンス

​スキーマ

​なぜ重要か

​サポートされるキー

​レシピ

​よくある間違い

​関連項目

フィルター概要

人物 + 企業フィルター

企業検索リファレンス

人物検索リファレンス

スキーマ

なぜ重要か

サポートされるキー

レシピ

よくある間違い

関連項目