メインコンテンツへスキップ
POST
/
companies
/
search
cURL
curl --request POST \
  --url https://api.pubrio.com/companies/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "profile_id": 123,
  "locations": [
    "US",
    "SG",
    "CN"
  ],
  "exclude_locations": [
    "CN",
    "US",
    "RU",
    "CA"
  ],
  "technologies": [
    123
  ],
  "categories": [
    123
  ],
  "verticals": [
    123
  ],
  "vertical_categories": [
    123
  ],
  "vertical_sub_categories": [
    123
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "employees": [
    [
      1,
      10
    ],
    [
      11,
      20
    ],
    [
      10001
    ]
  ],
  "company_name": "pubrio",
  "founded_dates": [
    2018,
    2024
  ],
  "revenues": [
    0,
    100000
  ],
  "job_locations": [
    "US",
    "SG",
    "CN"
  ],
  "job_posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "job_titles": [
    "sales manager",
    "marketing manager"
  ],
  "news_categories": [
    "launches"
  ],
  "news_published_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "is_enable_similarity_search": true,
  "similarity_score": 0.7,
  "per_page": 25,
  "page": 1
}
'
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 45234700,
      "total_pages": 1809388
    },
    "companies": [
      {
        "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg",
        "company_name": "Twitter",
        "emails": [
          "..."
        ],
        "phones": [
          "..."
        ],
        "contacts": [
          "..."
        ],
        "founded_year": 2006,
        "specialties": [
          "Software Development"
        ],
        "industry": "Software Development",
        "domain": "twitter.com",
        "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a",
        "domain_id": 224475931,
        "linkedin_company_id": 44005587,
        "linkedin_name": "twitter",
        "is_company_url_active": true,
        "domain_ids": [
          224475931,
          1758889566,
          368242865
        ],
        "company_keywords": [
          "realtime information",
          "social commerce",
          "online shopping",
          "classifieds",
          "craigslist killers",
          "e-commerce",
          "killers",
          "consumer internet",
          "internet",
          "information technology",
          "edp services",
          "technology",
          "software development",
          "microblogging",
          "social networking",
          "public conversation",
          "user engagement",
          "content sharing",
          "advertising solutions",
          "monetization",
          "community building",
          "digital wallet",
          "ai integration",
          "user safety"
        ],
        "company_size": 1500,
        "youtube_url": null,
        "crunchbase_url": null,
        "linkedin_url": "http://www.linkedin.com/company/twitter",
        "instagram_url": null,
        "facebook_url": "http://facebook.com/twitterinc",
        "twitter_url": "https://twitter.com/x",
        "github_url": null,
        "x_url": null,
        "location": "United States",
        "company_ranking": null,
        "company_url": "http://twitter.com",
        "saved_lists": null,
        "company_size_printed": "1,500"
      },
      "..."
    ]
  }
}

Authorizations

​
pubrio-api-key
string
header
required

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

Body

application/json
​
profile_id
integer
required

リクエストを送信するチームを表す識別子です。この ID によって検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。

​
locations
string[]

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

Example:
["US", "SG", "CN"]
​
exclude_locations
string[]

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

Example:
["CN", "US", "RU", "CA"]
​
technologies
integer[]

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

​
categories
integer[]

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

​
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 を検索できます。

​
companies
string<uuid>[]

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

​
domains
string[]

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

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

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

Example:
["https://www.linkedin.com/company/pubrio"]
​
employees
string[][]

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

Example:
[[1, 10], [11, 20], [10001]]
​
company_name
string

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

Example:

"pubrio"

​
founded_dates
integer[]

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

Example:
[2018, 2024]
​
revenues
integer[]

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

Example:
[0, 100000]
​
job_locations
string[]

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

Example:
["US", "SG", "CN"]
​
job_posted_dates
string[]

求人の掲載日レンジです。最大値には当日が指定可能です。

Example:
["2025-01-01", "2025-01-10"]
​
job_titles
string[]

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

Example:
["sales manager", "marketing manager"]
​
news_categories
string[]

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

Example:
["launches"]
​
news_published_dates
string[]

ニュースの公開日レンジです。最大値には当日が指定可能です。

Example:
["2025-01-01", "2025-01-10"]
​
is_enable_similarity_search
boolean

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

​
similarity_score
number<float>

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

Example:

0.7

​
per_page
integer

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

Example:

25

​
page
integer

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

Example:

1

Response

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

​
data
object

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