跳转到主要内容
POST
/
companies
/
search
搜索公司
curl --request POST \
  --url https://api.pubrio.com/companies/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "company_name": "pubrio",
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "company_filters": {
    "company_locations": [
      "US"
    ],
    "technologies": [
      37,
      152
    ],
    "founded_dates": [
      2015,
      2023
    ],
    "filter_conditions": [
      {
        "key": "technologies",
        "operator": "and"
      }
    ]
  },
  "locations": [
    "US",
    "SG",
    "CN"
  ],
  "exclude_locations": [
    "CN",
    "US",
    "RU",
    "CA"
  ],
  "places": [
    "Tokyo"
  ],
  "exclude_places": [
    "Tokyo"
  ],
  "job_locations": [
    "US",
    "SG",
    "CN"
  ],
  "job_exclude_locations": [
    "CN",
    "US",
    "RU",
    "CA"
  ],
  "job_posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "job_titles": [
    "sales manager",
    "marketing manager"
  ],
  "verticals": [
    123
  ],
  "vertical_categories": [
    123
  ],
  "vertical_sub_categories": [
    123
  ],
  "categories": [
    123
  ],
  "technologies": [
    123
  ],
  "employees": [
    [
      1,
      10
    ],
    [
      11,
      20
    ],
    [
      10001
    ]
  ],
  "revenues": [
    0,
    100000
  ],
  "founded_dates": [
    2018,
    2024
  ],
  "keywords": [
    "ecommerce",
    "ai",
    "fintech"
  ],
  "news_categories": [
    "launches"
  ],
  "news_published_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "advertisement_search_terms": [
    "asus"
  ],
  "advertisement_target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "advertisement_exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "advertisement_start_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "advertisement_end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "filter_conditions": [
    {
      "key": "keywords",
      "operator": "or"
    }
  ],
  "is_enable_similarity_search": true,
  "similarity_score": 0.7,
  "exclude_fields": [
    "emails",
    "phones",
    "contacts"
  ],
  "is_parameter_metadata_available": true,
  "is_profile_metadata_available": true,
  "per_page": 25,
  "page": 1,
  "profile_id": 123
}
'
import requests

url = "https://api.pubrio.com/companies/search"

payload = {
    "company_name": "pubrio",
    "companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "domains": ["pubrio.com"],
    "linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
    "company_filters": {
        "company_locations": ["US"],
        "technologies": [37, 152],
        "founded_dates": [2015, 2023],
        "filter_conditions": [
            {
                "key": "technologies",
                "operator": "and"
            }
        ]
    },
    "locations": ["US", "SG", "CN"],
    "exclude_locations": ["CN", "US", "RU", "CA"],
    "places": ["Tokyo"],
    "exclude_places": ["Tokyo"],
    "job_locations": ["US", "SG", "CN"],
    "job_exclude_locations": ["CN", "US", "RU", "CA"],
    "job_posted_dates": ["2025-01-01", "2025-01-10"],
    "job_titles": ["sales manager", "marketing manager"],
    "verticals": [123],
    "vertical_categories": [123],
    "vertical_sub_categories": [123],
    "categories": [123],
    "technologies": [123],
    "employees": [[1, 10], [11, 20], [10001]],
    "revenues": [0, 100000],
    "founded_dates": [2018, 2024],
    "keywords": ["ecommerce", "ai", "fintech"],
    "news_categories": ["launches"],
    "news_published_dates": ["2025-01-01", "2025-01-10"],
    "advertisement_search_terms": ["asus"],
    "advertisement_target_locations": ["TW", "AE", "NO"],
    "advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
    "advertisement_start_dates": ["2025-12-25", "2025-12-25"],
    "advertisement_end_dates": ["2025-12-25", "2025-12-25"],
    "filter_conditions": [
        {
            "key": "keywords",
            "operator": "or"
        }
    ],
    "is_enable_similarity_search": True,
    "similarity_score": 0.7,
    "exclude_fields": ["emails", "phones", "contacts"],
    "is_parameter_metadata_available": True,
    "is_profile_metadata_available": True,
    "per_page": 25,
    "page": 1,
    "profile_id": 123
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    company_name: 'pubrio',
    companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    domains: ['pubrio.com'],
    linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
    company_filters: {
      company_locations: ['US'],
      technologies: [37, 152],
      founded_dates: [2015, 2023],
      filter_conditions: [{key: 'technologies', operator: 'and'}]
    },
    locations: ['US', 'SG', 'CN'],
    exclude_locations: ['CN', 'US', 'RU', 'CA'],
    places: ['Tokyo'],
    exclude_places: ['Tokyo'],
    job_locations: ['US', 'SG', 'CN'],
    job_exclude_locations: ['CN', 'US', 'RU', 'CA'],
    job_posted_dates: ['2025-01-01', '2025-01-10'],
    job_titles: ['sales manager', 'marketing manager'],
    verticals: [123],
    vertical_categories: [123],
    vertical_sub_categories: [123],
    categories: [123],
    technologies: [123],
    employees: [[1, 10], [11, 20], [10001]],
    revenues: [0, 100000],
    founded_dates: [2018, 2024],
    keywords: ['ecommerce', 'ai', 'fintech'],
    news_categories: ['launches'],
    news_published_dates: ['2025-01-01', '2025-01-10'],
    advertisement_search_terms: ['asus'],
    advertisement_target_locations: ['TW', 'AE', 'NO'],
    advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
    advertisement_start_dates: ['2025-12-25', '2025-12-25'],
    advertisement_end_dates: ['2025-12-25', '2025-12-25'],
    filter_conditions: [{key: 'keywords', operator: 'or'}],
    is_enable_similarity_search: true,
    similarity_score: 0.7,
    exclude_fields: ['emails', 'phones', 'contacts'],
    is_parameter_metadata_available: true,
    is_profile_metadata_available: true,
    per_page: 25,
    page: 1,
    profile_id: 123
  })
};

fetch('https://api.pubrio.com/companies/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/companies/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'company_name' => 'pubrio',
    'companies' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'domains' => [
        'pubrio.com'
    ],
    'linkedin_urls' => [
        'https://www.linkedin.com/company/pubrio'
    ],
    'company_filters' => [
        'company_locations' => [
                'US'
        ],
        'technologies' => [
                37,
                152
        ],
        'founded_dates' => [
                2015,
                2023
        ],
        'filter_conditions' => [
                [
                                'key' => 'technologies',
                                'operator' => 'and'
                ]
        ]
    ],
    'locations' => [
        'US',
        'SG',
        'CN'
    ],
    'exclude_locations' => [
        'CN',
        'US',
        'RU',
        'CA'
    ],
    'places' => [
        'Tokyo'
    ],
    'exclude_places' => [
        'Tokyo'
    ],
    'job_locations' => [
        'US',
        'SG',
        'CN'
    ],
    'job_exclude_locations' => [
        'CN',
        'US',
        'RU',
        'CA'
    ],
    'job_posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'job_titles' => [
        'sales manager',
        'marketing manager'
    ],
    'verticals' => [
        123
    ],
    'vertical_categories' => [
        123
    ],
    'vertical_sub_categories' => [
        123
    ],
    'categories' => [
        123
    ],
    'technologies' => [
        123
    ],
    'employees' => [
        [
                1,
                10
        ],
        [
                11,
                20
        ],
        [
                10001
        ]
    ],
    'revenues' => [
        0,
        100000
    ],
    'founded_dates' => [
        2018,
        2024
    ],
    'keywords' => [
        'ecommerce',
        'ai',
        'fintech'
    ],
    'news_categories' => [
        'launches'
    ],
    'news_published_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'advertisement_search_terms' => [
        'asus'
    ],
    'advertisement_target_locations' => [
        'TW',
        'AE',
        'NO'
    ],
    'advertisement_exclude_target_locations' => [
        'IS',
        'GB',
        'FR',
        'IE',
        'ES'
    ],
    'advertisement_start_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'advertisement_end_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'filter_conditions' => [
        [
                'key' => 'keywords',
                'operator' => 'or'
        ]
    ],
    'is_enable_similarity_search' => true,
    'similarity_score' => 0.7,
    'exclude_fields' => [
        'emails',
        'phones',
        'contacts'
    ],
    'is_parameter_metadata_available' => true,
    'is_profile_metadata_available' => true,
    'per_page' => 25,
    'page' => 1,
    'profile_id' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pubrio.com/companies/search"

	payload := strings.NewReader("{\n  \"company_name\": \"pubrio\",\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"company_filters\": {\n    \"company_locations\": [\n      \"US\"\n    ],\n    \"technologies\": [\n      37,\n      152\n    ],\n    \"founded_dates\": [\n      2015,\n      2023\n    ],\n    \"filter_conditions\": [\n      {\n        \"key\": \"technologies\",\n        \"operator\": \"and\"\n      }\n    ]\n  },\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"places\": [\n    \"Tokyo\"\n  ],\n  \"exclude_places\": [\n    \"Tokyo\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"filter_conditions\": [\n    {\n      \"key\": \"keywords\",\n      \"operator\": \"or\"\n    }\n  ],\n  \"is_enable_similarity_search\": true,\n  \"similarity_score\": 0.7,\n  \"exclude_fields\": [\n    \"emails\",\n    \"phones\",\n    \"contacts\"\n  ],\n  \"is_parameter_metadata_available\": true,\n  \"is_profile_metadata_available\": true,\n  \"per_page\": 25,\n  \"page\": 1,\n  \"profile_id\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("pubrio-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.pubrio.com/companies/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"company_name\": \"pubrio\",\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"company_filters\": {\n    \"company_locations\": [\n      \"US\"\n    ],\n    \"technologies\": [\n      37,\n      152\n    ],\n    \"founded_dates\": [\n      2015,\n      2023\n    ],\n    \"filter_conditions\": [\n      {\n        \"key\": \"technologies\",\n        \"operator\": \"and\"\n      }\n    ]\n  },\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"places\": [\n    \"Tokyo\"\n  ],\n  \"exclude_places\": [\n    \"Tokyo\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"filter_conditions\": [\n    {\n      \"key\": \"keywords\",\n      \"operator\": \"or\"\n    }\n  ],\n  \"is_enable_similarity_search\": true,\n  \"similarity_score\": 0.7,\n  \"exclude_fields\": [\n    \"emails\",\n    \"phones\",\n    \"contacts\"\n  ],\n  \"is_parameter_metadata_available\": true,\n  \"is_profile_metadata_available\": true,\n  \"per_page\": 25,\n  \"page\": 1,\n  \"profile_id\": 123\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/companies/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"company_name\": \"pubrio\",\n  \"companies\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"company_filters\": {\n    \"company_locations\": [\n      \"US\"\n    ],\n    \"technologies\": [\n      37,\n      152\n    ],\n    \"founded_dates\": [\n      2015,\n      2023\n    ],\n    \"filter_conditions\": [\n      {\n        \"key\": \"technologies\",\n        \"operator\": \"and\"\n      }\n    ]\n  },\n  \"locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"places\": [\n    \"Tokyo\"\n  ],\n  \"exclude_places\": [\n    \"Tokyo\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"filter_conditions\": [\n    {\n      \"key\": \"keywords\",\n      \"operator\": \"or\"\n    }\n  ],\n  \"is_enable_similarity_search\": true,\n  \"similarity_score\": 0.7,\n  \"exclude_fields\": [\n    \"emails\",\n    \"phones\",\n    \"contacts\"\n  ],\n  \"is_parameter_metadata_available\": true,\n  \"is_profile_metadata_available\": true,\n  \"per_page\": 25,\n  \"page\": 1,\n  \"profile_id\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "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"
      },
      "..."
    ]
  }
}
{
  "code": 40001,
  "message": "错误及代码会根据不同场景有所不同，详情请参阅文档。",
  "details": {}
}
{
  "error": "请求频率超出限制。请稍后再试。"
}
{
  "error": "服务器在处理请求时遇到了未预料的异常。"
}

授权

​
pubrio-api-key
string
header
必填

一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
​
company_name
string

筛选搜索结果，仅包含指定公司名称。

如果输入的值与公司名称不匹配，则该公司不会出现在搜索结果中，即使其他参数匹配也不会。支持部分匹配。

示例:

"pubrio"

​
companies
string<uuid>[]

用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。

​
domains
string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 pubrio.com 进行处理。

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

LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/。

示例:
["https://www.linkedin.com/company/pubrio"]
​
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 结构一致。示例见筛选器概览开发者指南。

示例:
{
  "company_locations": ["US"],
  "technologies": [37, 152],
  "founded_dates": [2015, 2023],
  "filter_conditions": [
    { "key": "technologies", "operator": "and" }
  ]
}
​
locations
string[]

ISO 3166-1 alpha-2（cca2）用于筛选地区。更多信息请参见筛选器标签下的 location 端点。

示例:
["US", "SG", "CN"]
​
exclude_locations
string[]

ISO 3166-1 alpha-2（cca2）用于筛选不需要返回的地区。更多信息请参见筛选器标签下的 location 端点。

示例:
["CN", "US", "RU", "CA"]
​
places
string[]

用于筛选结果的地点名称（城市或地区）。接受本地化或英文地点名称。

示例:
["Tokyo"]
​
exclude_places
string[]

要从结果中排除的地点名称（城市或地区）。接受本地化或英文地点名称。

示例:
["Tokyo"]
​
job_locations
string[]

ISO 3166-1 alpha-2（cca2）用于筛选地区。更多信息请参见筛选器标签下的 location 端点。

示例:
["US", "SG", "CN"]
​
job_exclude_locations
string[]

从职位发布结果中排除的地理位置。

示例:
["CN", "US", "RU", "CA"]
​
job_posted_dates
string[]

发布日期的时间范围。最大值为当天。

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

与目标人员相关的职位名称。

结果还将包含包含类似术语的职位，即使不完全匹配。例如，搜索 software engineer 也可能返回职位为 senior software engineer 的人员。

示例:
["sales manager", "marketing manager"]
​
verticals
integer[]

vertical_id 列表，用于搜索特定垂直行业或领域的公司。要获取ID，请调用筛选器标签下的 vertical 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["AI"]。

​
vertical_categories
integer[]

vertical_category_id 列表，用于搜索特定垂直行业类别的公司。要获取ID，请调用筛选器标签下的 vertical category 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["Information Technology"]。

​
vertical_sub_categories
integer[]

vertical_sub_category_id 列表，用于搜索特定垂直行业子类别的公司。要获取ID，请调用筛选器标签下的 vertical sub category 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["Software"]。

​
categories
integer[]

category_id 列表，用于搜索公司所用的特定技术类别。要获取ID，请调用筛选器标签下的 category 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["CDN"]。

​
technologies
integer[]

tag_id 列表，用于搜索公司所用的特定技术。要获取ID，请调用筛选器标签下的 technology 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["Shopify"]。

​
employees
string[][]

公司员工人数范围。可根据员工总数筛选公司，并可添加多个范围以扩展搜索结果。

更多信息请参见筛选器标签下的 company size 端点。

示例:
[[1, 10], [11, 20], [10001]]
​
revenues
integer[]

公司收入的最小值和最大值范围。

示例:
[0, 100000]
​
founded_dates
integer[]

公司成立年份范围。最大值为当前年份。

示例:
[2018, 2024]
​
keywords
string[]

用于按相关性、专业或描述对公司进行关键词筛选的列表。

示例:
["ecommerce", "ai", "fintech"]
​
news_categories
string[]

category slugs 列表，用于搜索特定新闻类别。要获取 slug，请调用筛选器标签下的 news categories 端点。

示例:
["launches"]
​
news_published_dates
string[]

发布时间的时间范围。最大值为当天。

示例:
["2025-01-01", "2025-01-10"]
​
advertisement_search_terms
string[]

用于在广告内容或标题中搜索的关键词。

示例:
["asus"]
​
advertisement_target_locations
string[]

广告的目标地理位置。

示例:
["TW", "AE", "NO"]
​
advertisement_exclude_target_locations
string[]

从广告定位中排除的地理位置。

示例:
["IS", "GB", "FR", "IE", "ES"]
​
advertisement_start_dates
string<date>[]

用于广告筛选的起始日期范围。

示例:
["2025-12-25", "2025-12-25"]
​
advertisement_end_dates
string<date>[]

用于广告筛选的结束日期范围。

示例:
["2025-12-25", "2025-12-25"]
​
filter_conditions
object[]

公司搜索的高级筛选选项。指定结合键与逻辑运算符的条件以优化搜索结果。

​
is_enable_similarity_search
boolean

启用后，上述支持相似度搜索的筛选器可直接填写自由文本以检索特定ID。

​
similarity_score
number<float>

需与 is_enable_similarity_search 配合使用。该数值用于分析特定 slug（如行业、技术）与用户输入的相似程度，数值越高，匹配越严格。

示例:

0.7

​
exclude_fields
string[]

要从响应中排除的字段列表。

示例:
["emails", "phones", "contacts"]
​
is_parameter_metadata_available
boolean

指示请求中是否可用参数元数据。

​
is_profile_metadata_available
boolean

指示请求中是否可用配置文件元数据。

​
per_page
integer

每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。

示例:

25

​
page
integer

要检索的数据页码。

示例:

1

​
profile_id
integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

包含相关详细信息的成功响应。

​
data
object | null

响应信息取决于具体接口。