Skip to main content
POST
企業検索

承認

​
pubrio-api-key
string
header
必須

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

ボディ

application/json
​
company_name
string

検索結果を、指定した社名に一致する企業のみに絞り込むためのフィルターです。入力値が企業名と一致しない場合、その企業は他の条件を満たしていても結果に含まれず、部分一致によるマッチングもサポートされます。

例:

"pubrio"

​
companies
string<uuid>[]

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

​
company_groups
integer[]

これらの企業グループ（ID）のメンバーに限定します。モニターの source_group_id や excluded_group_id など。他の検索と同様にページングされます。

​
domains
string[]

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

例:
​
linkedin_urls
string[]

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

例:
​
company_filters
object

企業レベルフィルターのラッパーオブジェクト。推奨グループ化 — どのキーが人物を絞り(トップレベル)、どのキーが企業を絞るかを視覚的に分けます。トップレベルの企業フィルターと同じキーを受け付けます(例: technologies、verticals、vertical_categories、vertical_sub_categories、categories、keywords、founded_dates、employees、revenues、company_locations、company_exclude_locations、company_places、company_exclude_places、companies、domains、company_linkedin_urls、is_enable_similarity_search、similarity_score、および filter_conditions)。エンジンは処理前にこのオブジェクトをトップレベルに展開します — 同名キーがある場合はトップレベルが勝ちます。Monitor company_filters と同じ形状です。例はフィルター概要開発者ガイドを参照してください。

例:
​
locations
string[]

ISO 3166-1 alpha-2（CCA2）コードで地域を指定するフィルターです。詳細はフィルタータブの location エンドポイントを参照します。

例:
​
exclude_locations
string[]

ISO 3166-1 alpha-2 コードで、検索結果から除外する地域を指定します。

例:
​
places
string[]

結果をフィルタリングするための場所名（都市または地域）です。ローカライズまたは英語の場所名を受け付けます。

例:
​
exclude_places
string[]

結果から除外する場所名（都市または地域）です。ローカライズまたは英語の場所名を受け付けます。

例:
​
job_locations
string[]

ISO 3166-1 alpha-2（CCA2）コードで地域を指定するフィルターです。詳細はフィルタータブの location エンドポイントを参照します。

例:
​
job_exclude_locations
string[]

求人結果から除外する地理的位置。

例:
​
job_posted_dates
string[]

求人の掲載日レンジです。最大値には当日が指定可能です。 日付境界はワークスペースのタイムゾーンに従います。

例:
​
job_titles
string[]

対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます（例：software engineer で senior software engineer もヒット）。

例:
​
verticals
integer[]

特定の業界・業種セグメントに属する企業を検索するための vertical_id 一覧です。is_enable_similarity_search を有効化すると、["AI"] などの自由テキスト入力が可能です。

​
vertical_categories
integer[]

特定の業界カテゴリに属する企業を検索するための vertical_category_id の一覧です。フィルターは is_enable_similarity_search に対応しており、有効化すると ["Information Technology"] のような自由テキストから候補 ID を解決できます。

​
vertical_sub_categories
integer[]

特定の業界サブカテゴリに属する企業を検索するための vertical_sub_category_id の一覧です。is_enable_similarity_search を有効化すると、["Software"] のような自由テキスト入力に基づいて関連 ID を検索できます。

​
categories
integer[]

特定のテクノロジーカテゴリを利用している企業を検索するための category_id 一覧です。is_enable_similarity_search を有効化すると、["CDN"] のような自由テキスト入力も可能になります。

​
technologies
integer[]

特定のテクノロジーを利用している企業を検索するための tag_id 一覧です。ID はフィルタータブの technology エンドポイントから取得します。is_enable_similarity_search を有効化すると、["Shopify"] のような自由テキスト入力も可能になります。

テクノロジー一覧にある製品名は、その製品と同社の製品に一致します（"Salesforce" は Salesforce Desk や Salesforce Service Cloud にも一致）。似た別製品には一致しません。それ以外のテキストは類似度で一致します。

​
exclude_technologies
string[]

企業が使っていてはならない技術。tag_id、または is_enable_similarity_search 有効時は ["Shopify"] のような名称で指定します。既知の技術がない企業は残ります。

例:
​
employees
string[][]

企業の従業員数レンジを表します。複数レンジを指定することで、対象となる会社規模の幅を広げられます。詳細は company size エンドポイントを参照します。

例:
​
revenues
integer[]

企業収益の最小値と最大値を表すレンジです。

例:
​
founded_dates
integer[]

企業の設立年レンジです。最大値には当年が指定可能です。

例:
​
keywords
string[]

会社を関連性、専門分野、または説明でフィルタリングするためのキーワードのリスト。

例:
​
social_media
enum<string>[]

次のいずれかにプロフィールを持つ企業：linkedin、facebook、instagram、tiktok、twitter、x、github、wantedly、rocketpunch。filter_conditions で AND に昇格できます。

利用可能なオプション:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
例:
​
news_categories
string[]

特定のニュースカテゴリを検索するためのカテゴリスラッグ一覧です。スラッグは news categories エンドポイントから取得します。

例:
​
news_published_dates
string[]

ニュースの公開日レンジです。最大値には当日が指定可能です。 日付境界はワークスペースのタイムゾーンに従います。

例:
​
advertisement_search_terms
string[]

広告コンテンツやタイトル内で検索するために使用するキーワードです。

例:
​
advertisement_target_locations
string[]

広告のターゲット地理的位置。

例:
​
advertisement_exclude_target_locations
string[]

広告ターゲティングから除外する地理的位置。

例:
​
advertisement_start_dates
string<date>[]

広告フィルタリングの開始日範囲です。

例:
​
advertisement_end_dates
string<date>[]

広告フィルタリングの終了日範囲です。

例:
​
advertisement_active_dates
string<date>[]

この日付範囲内のいずれかの時点で配信中だった広告を検索します(期間重複方式 — 範囲より前に開始し、現在も配信中の広告も含みます。範囲内に開始した広告だけではありません)。

例:
​
advertisement_status
enum<string>[]

currently_running：広告レコードのある企業。active_last_30_min：直近 30 分以内に広告に変化があった企業。

利用可能なオプション:
currently_running,
active_last_30_min
例:
​
advertisement_headlines
string[]

広告の見出しテキスト内を検索するキーワードです。

例:
​
advertisement_platforms
enum<string>[]

広告の取得元となった広告ライブラリでフィルタリングします。小文字で、大文字・小文字を区別しません。meta は facebook の別名として受け付けられます。

利用可能なオプション:
linkedin,
facebook,
google,
tiktok,
apple
例:
​
advertisement_publisher_platforms
enum<string>[]

配信された配置面で Facebook/Meta 広告をフィルタリングします。小文字で、大文字・小文字を区別しません。facebook ソースにのみ適用されます（他のソースは単一プラットフォーム）。

利用可能なオプション:
facebook,
instagram,
messenger,
threads,
audience_network
例:
​
advertisement_exclude_publisher_platforms
enum<string>[]

これらの配置面で配信された Facebook/Meta 広告を除外します。

利用可能なオプション:
facebook,
instagram,
messenger,
threads,
audience_network
例:
​
advertisement_formats
enum<string>[]

これらのクリエイティブフォーマットのいずれかで、広告を少なくとも 1 件出稿している企業を検索します。

利用可能なオプション:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
例:
​
advertisement_active_ads
(integer | null)[]

企業が現在アクティブにしている広告件数の最小値と最大値です(すべての国の合計)。上限または下限を設けない場合は null を指定します。例:「アクティブな広告が 1 件以上」を表すには [1, null] とします。

Required array length: 2 elements
例:
​
advertisement_running_ads
(integer | null)[]

企業の広告のうち、配信が終了していないもの(終了日が未設定、または終了日が未来の日付)の件数の最小値と最大値です。現時点では LinkedIn 広告にのみデータが存在します。

Required array length: 2 elements
例:
​
advertisement_total_ads
(integer | null)[]

これまでに記録された、企業の広告の総件数の最小値と最大値です(すべての国の合計)。

Required array length: 2 elements
例:
​
advertisement_platform_count
(integer | null)[]

企業が現在広告を出稿している、異なる広告プラットフォーム(linkedin、facebook、google、tiktok、apple)の数の最小値と最大値です。

Required array length: 2 elements
例:
​
advertisement_format_count
(integer | null)[]

企業が現在配信している、異なる広告クリエイティブフォーマットの数の最小値と最大値です。

Required array length: 2 elements
例:
​
advertisement_impressions_estimate
(integer | null)[]

推定広告インプレッション数の最小値と最大値です(すべての国の合計)。インプレッション範囲が報告されている広告のみが集計対象です。

Required array length: 2 elements
例:
​
advertisement_country_activity
object

特定の 1 か国における広告アクティビティです。country は必須で、それ以外のフィールドを少なくとも 1 つ指定する必要があります(country のみでは何にもマッチしません)。すべての国を合計した値を求める場合は、代わりにトップレベルの advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate フィルターを使用してください。

例:
​
sort_by
enum<string>

結果の並び順。省略した場合はデフォルトの関連度順が適用されます。advertisement_country_rank は、advertisement_country_activity で指定した国における企業の広告ランク順に並べ替えます（ランク 1 = その市場で最大の広告主）。このフィルターがない場合は無視されます。is_ascending_order: false と組み合わせると、最小の広告主から順に表示されます。 現在未対応：name（昇順・降順とも）および is_ascending_order: false を指定した relevance — これらのリクエストはタイムアウトします。デフォルトの関連度順、number_of_employees、founded_year をご利用ください。

利用可能なオプション:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
例:

"advertisement_country_rank"

​
is_ascending_order
boolean

sort_by の並び順です。デフォルトは昇順で、advertisement_country_rank の場合は最大の広告主が先頭になります。

例:

true

​
filter_conditions
object[]

企業検索の高度なフィルタリングオプションです。キーと論理演算子を組み合わせた条件を指定して検索結果を絞り込めます。

​
is_enable_similarity_search
boolean

対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。

​
similarity_score
number<float>

is_enable_similarity_search と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。

例:

0.7

​
query
string

自然言語検索。指定すると、Pubrio が以下の企業フィルターに変換します：業種（および除外する業種）、専門分野、テクノロジー（および使っていないツール）、SNS プロフィール、本社の国・地域・都市、従業員数、売上高、設立年、採用中の職種とその勤務地、「最近拡大した」などのニュースイベント、広告（プラットフォーム、形式、配信国、広告数、インプレッション、日付、特定の国での順位）、クラウドホスティング（プロバイダー、サーバーの所在国と都市、ホスト数とサーバー数、全体または特定の国での値）。「または」でつないだ値はいずれかに一致すれば対象になり、「と」でつないだツールやプロフィール（「Salesforce と HubSpot の両方を使用」）はすべてに一致する必要があります。同時に明示的に指定したフィルターは、解釈結果より優先されます。どのフィルターでも表現できない部分（例：所有形態）は破棄されず metadata.unmatched_criteria で返され、検索できる内容がない文は metadata.nl_no_intent: true とともに結果なしで返されます。

例:

"Food & Beverage companies in Singapore that recently expanded"

​
exclude_fields
string[]

レスポンスペイロードから除外するフィールドのリストです。

例:
​
is_parameter_metadata_available
boolean

リクエストにパラメータメタデータが利用可能かどうかを示します。

​
is_profile_metadata_available
boolean

リクエストにプロファイルメタデータが利用可能かどうかを示します。

​
per_page
integer
デフォルト:25

1 ページあたりの件数。既定は 25 で、多くのプランではこれが上限でもあります。制限値はサブスクリプションの max_search_per_page で、Profile から取得できます。超過すると結果が丸められるのではなく、HTTP 416 とコード 41676（企業・人物検索では 41613）が返ります。

必須範囲: x <= 25
例:

25

​
page
integer
デフォルト:1

ページ番号（1 から開始）。上限はサブスクリプションの max_search_page（企業検索では max_company_search_page）で、Profile から取得できます。超過すると HTTP 416 が返ります。

例:

1

​
cloud_footprint_providers
string[]

いずれかのプロバイダーをどこかで利用している企業。接頭辞なしの providers は返る行を、こちらは企業を絞り込みます。

例:
​
cloud_footprint_exclude_providers
string[]

これらのクラウド／ホスティングプロバイダーに一致するフットプリント行を除外します。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

例:
​
cloud_footprint_target_locations
string[]

フットプリントのいずれかでこれらの国に存在する企業。

例:
​
cloud_footprint_exclude_target_locations
string[]

これらのインフラが所在する国コードに一致するフットプリント行を除外します。

例:
​
cloud_footprint_cloud_regions
string[]

これらのクラウドリージョンに一致するフットプリント行のみを返します。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

例:
​
cloud_footprint_exclude_cloud_regions
string[]

これらのクラウドリージョンに一致するフットプリント行を除外します。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

例:
​
cloud_footprint_cities
string[]

これらの都市に一致するフットプリント行のみを返します。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

例:
​
cloud_footprint_exclude_cities
string[]

これらの都市に一致するフットプリント行を除外します。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

例:
​
cloud_footprint_first_seen_dates
(string | null)[]

フットプリントが最初に検出された時期を区切る 2 つの ISO 8601 日付（YYYY-MM-DD）。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

Required array length: 2 elements
例:
​
cloud_footprint_last_seen_dates
(string | null)[]

フットプリントが最後に検出された時期を区切る 2 つの ISO 8601 日付（YYYY-MM-DD）。 このフットプリント行（1 プロバイダー × 1 か国）に限定されます。

Required array length: 2 elements
例:
​
cloud_footprint_is_cross_border_only
boolean

true の場合、自国市場以外のフットプリント行のみを返します。本社所在地が不明な企業の行は除外されます。

例:

true

​
cloud_footprint_host_count
(integer | null)[]

ホスト数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_server_count
(integer | null)[]

サーバー数（一意の IP）の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_shared_server_count
(integer | null)[]

他社と共有するサーバー数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_provider_count
(integer | null)[]

企業が利用するプロバイダー数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_country_count
(integer | null)[]

企業がホスティングする国数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_cross_border_country_count
(integer | null)[]

自国市場以外の国数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_region_count
(integer | null)[]

クラウドリージョン数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_city_count
(integer | null)[]

都市数の最小値と最大値。上限または下限を設けない場合は null を使用します。 企業全体（すべてのプロバイダーと国）で集計されます。

Required array length: 2 elements
例:
​
cloud_footprint_primary_provider
string[]

最大のプロバイダーがこれらのいずれかである企業。

例:
​
cloud_footprint_country_activity
object

1 か国に絞った範囲条件です。{"country":"DE","host_count":[100,null]} はドイツで 100 以上のホストを運用する企業を抽出します。単体の cloud_footprint_host_count は全世界の合計なので、両者の組み合わせでは表現できません。country だけの指定は拒否されます。

レスポンス

関連する詳細情報を含む成功レスポンスです。

​
metadata
object

リクエストのコンテキスト：recent_search_log_identifier、エコーされた parameters と filters、任意の profile クレジット情報、ignored_fields（エンドポイントが破棄したボディキー）。

​
data
object | null

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

最終更新日 2025年12月8日