Expansions-Rankings
curl --request POST \
--url https://api.pubrio.com/expansions/companies/rankings \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"froms": [
"US",
"GB"
],
"tos": [
"US",
"GB"
],
"exclude_froms": [
"US",
"GB"
],
"exclude_tos": [
"US",
"GB"
],
"stages": [
"committing",
"expanding"
],
"signal_types": [
"EXEC",
"HIRE"
],
"signal_strengths": [
"high"
],
"min_signal_count": 3,
"only_contraction": false,
"domain_search_ids": [
"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
],
"verticals": [
123
],
"vertical_categories": [
123
],
"vertical_sub_categories": [
123
],
"technologies": [
123
],
"employees": [
[
1,
10
],
[
11,
20
],
[
10001
]
],
"revenues": [
0,
100000
],
"founded_dates": [
2018,
2024
],
"keywords": [
"ecommerce",
"ai",
"fintech"
],
"companies": [
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
],
"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"
],
"advertisement_target_locations": [
"TW",
"AE",
"NO"
],
"advertisement_exclude_target_locations": [
"IS",
"GB",
"FR",
"IE",
"ES"
],
"advertisement_search_terms": [
"asus"
],
"advertisement_start_dates": [
"2025-12-25",
"2025-12-25"
],
"advertisement_end_dates": [
"2025-12-25",
"2025-12-25"
],
"news_categories": [
"launches"
],
"news_published_dates": [
"2025-01-01",
"2025-01-10"
],
"is_include_established": false,
"select_size": 50,
"is_include_metadata": true,
"is_enable_similarity_search": true
}
'import requests
url = "https://api.pubrio.com/expansions/companies/rankings"
payload = {
"froms": ["US", "GB"],
"tos": ["US", "GB"],
"exclude_froms": ["US", "GB"],
"exclude_tos": ["US", "GB"],
"stages": ["committing", "expanding"],
"signal_types": ["EXEC", "HIRE"],
"signal_strengths": ["high"],
"min_signal_count": 3,
"only_contraction": False,
"domain_search_ids": ["8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"],
"verticals": [123],
"vertical_categories": [123],
"vertical_sub_categories": [123],
"technologies": [123],
"employees": [[1, 10], [11, 20], [10001]],
"revenues": [0, 100000],
"founded_dates": [2018, 2024],
"keywords": ["ecommerce", "ai", "fintech"],
"companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],
"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"],
"advertisement_target_locations": ["TW", "AE", "NO"],
"advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
"advertisement_search_terms": ["asus"],
"advertisement_start_dates": ["2025-12-25", "2025-12-25"],
"advertisement_end_dates": ["2025-12-25", "2025-12-25"],
"news_categories": ["launches"],
"news_published_dates": ["2025-01-01", "2025-01-10"],
"is_include_established": False,
"select_size": 50,
"is_include_metadata": True,
"is_enable_similarity_search": True
}
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({
froms: ['US', 'GB'],
tos: ['US', 'GB'],
exclude_froms: ['US', 'GB'],
exclude_tos: ['US', 'GB'],
stages: ['committing', 'expanding'],
signal_types: ['EXEC', 'HIRE'],
signal_strengths: ['high'],
min_signal_count: 3,
only_contraction: false,
domain_search_ids: ['8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c'],
verticals: [123],
vertical_categories: [123],
vertical_sub_categories: [123],
technologies: [123],
employees: [[1, 10], [11, 20], [10001]],
revenues: [0, 100000],
founded_dates: [2018, 2024],
keywords: ['ecommerce', 'ai', 'fintech'],
companies: [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
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'],
advertisement_target_locations: ['TW', 'AE', 'NO'],
advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
advertisement_search_terms: ['asus'],
advertisement_start_dates: ['2025-12-25', '2025-12-25'],
advertisement_end_dates: ['2025-12-25', '2025-12-25'],
news_categories: ['launches'],
news_published_dates: ['2025-01-01', '2025-01-10'],
is_include_established: false,
select_size: 50,
is_include_metadata: true,
is_enable_similarity_search: true
})
};
fetch('https://api.pubrio.com/expansions/companies/rankings', 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/expansions/companies/rankings",
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([
'froms' => [
'US',
'GB'
],
'tos' => [
'US',
'GB'
],
'exclude_froms' => [
'US',
'GB'
],
'exclude_tos' => [
'US',
'GB'
],
'stages' => [
'committing',
'expanding'
],
'signal_types' => [
'EXEC',
'HIRE'
],
'signal_strengths' => [
'high'
],
'min_signal_count' => 3,
'only_contraction' => false,
'domain_search_ids' => [
'8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c'
],
'verticals' => [
123
],
'vertical_categories' => [
123
],
'vertical_sub_categories' => [
123
],
'technologies' => [
123
],
'employees' => [
[
1,
10
],
[
11,
20
],
[
10001
]
],
'revenues' => [
0,
100000
],
'founded_dates' => [
2018,
2024
],
'keywords' => [
'ecommerce',
'ai',
'fintech'
],
'companies' => [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
'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'
],
'advertisement_target_locations' => [
'TW',
'AE',
'NO'
],
'advertisement_exclude_target_locations' => [
'IS',
'GB',
'FR',
'IE',
'ES'
],
'advertisement_search_terms' => [
'asus'
],
'advertisement_start_dates' => [
'2025-12-25',
'2025-12-25'
],
'advertisement_end_dates' => [
'2025-12-25',
'2025-12-25'
],
'news_categories' => [
'launches'
],
'news_published_dates' => [
'2025-01-01',
'2025-01-10'
],
'is_include_established' => false,
'select_size' => 50,
'is_include_metadata' => true,
'is_enable_similarity_search' => true
]),
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/expansions/companies/rankings"
payload := strings.NewReader("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"domain_search_ids\": [\n \"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\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 \"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_search_terms\": [\n \"asus\"\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 \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"is_include_established\": false,\n \"select_size\": 50,\n \"is_include_metadata\": true,\n \"is_enable_similarity_search\": true\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/expansions/companies/rankings")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"domain_search_ids\": [\n \"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\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 \"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_search_terms\": [\n \"asus\"\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 \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"is_include_established\": false,\n \"select_size\": 50,\n \"is_include_metadata\": true,\n \"is_enable_similarity_search\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/companies/rankings")
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 \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"domain_search_ids\": [\n \"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\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 \"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_search_terms\": [\n \"asus\"\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 \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"is_include_established\": false,\n \"select_size\": 50,\n \"is_include_metadata\": true,\n \"is_enable_similarity_search\": true\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"froms": [
"CN"
],
"tos": [
"GB"
]
},
"select_size": 250,
"count": 1
},
"data": {
"markers": [
{
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
"country_code": "US",
"stage_slug": "expanding",
"expansion_score": 0.721,
"freshness": "fresh",
"direction": "advancing"
}
]
}
}{
"code": 40001,
"message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
"details": {}
}{
"error": "Request rate limit exceeded. Please wait and try again later."
}{
"error": "An unexpected error occurred on the server."
}Expansion
Expansions-Rankings
Leichtgewichtige, nach Expansionswert gerankte Liste von Unternehmen/Markt-Paaren – geeignet für die Darstellung als Karte oder Heatmap.
POST
/
expansions
/
companies
/
rankings
Expansions-Rankings
curl --request POST \
--url https://api.pubrio.com/expansions/companies/rankings \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"froms": [
"US",
"GB"
],
"tos": [
"US",
"GB"
],
"exclude_froms": [
"US",
"GB"
],
"exclude_tos": [
"US",
"GB"
],
"stages": [
"committing",
"expanding"
],
"signal_types": [
"EXEC",
"HIRE"
],
"signal_strengths": [
"high"
],
"min_signal_count": 3,
"only_contraction": false,
"domain_search_ids": [
"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
],
"verticals": [
123
],
"vertical_categories": [
123
],
"vertical_sub_categories": [
123
],
"technologies": [
123
],
"employees": [
[
1,
10
],
[
11,
20
],
[
10001
]
],
"revenues": [
0,
100000
],
"founded_dates": [
2018,
2024
],
"keywords": [
"ecommerce",
"ai",
"fintech"
],
"companies": [
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
],
"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"
],
"advertisement_target_locations": [
"TW",
"AE",
"NO"
],
"advertisement_exclude_target_locations": [
"IS",
"GB",
"FR",
"IE",
"ES"
],
"advertisement_search_terms": [
"asus"
],
"advertisement_start_dates": [
"2025-12-25",
"2025-12-25"
],
"advertisement_end_dates": [
"2025-12-25",
"2025-12-25"
],
"news_categories": [
"launches"
],
"news_published_dates": [
"2025-01-01",
"2025-01-10"
],
"is_include_established": false,
"select_size": 50,
"is_include_metadata": true,
"is_enable_similarity_search": true
}
'import requests
url = "https://api.pubrio.com/expansions/companies/rankings"
payload = {
"froms": ["US", "GB"],
"tos": ["US", "GB"],
"exclude_froms": ["US", "GB"],
"exclude_tos": ["US", "GB"],
"stages": ["committing", "expanding"],
"signal_types": ["EXEC", "HIRE"],
"signal_strengths": ["high"],
"min_signal_count": 3,
"only_contraction": False,
"domain_search_ids": ["8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"],
"verticals": [123],
"vertical_categories": [123],
"vertical_sub_categories": [123],
"technologies": [123],
"employees": [[1, 10], [11, 20], [10001]],
"revenues": [0, 100000],
"founded_dates": [2018, 2024],
"keywords": ["ecommerce", "ai", "fintech"],
"companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],
"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"],
"advertisement_target_locations": ["TW", "AE", "NO"],
"advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
"advertisement_search_terms": ["asus"],
"advertisement_start_dates": ["2025-12-25", "2025-12-25"],
"advertisement_end_dates": ["2025-12-25", "2025-12-25"],
"news_categories": ["launches"],
"news_published_dates": ["2025-01-01", "2025-01-10"],
"is_include_established": False,
"select_size": 50,
"is_include_metadata": True,
"is_enable_similarity_search": True
}
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({
froms: ['US', 'GB'],
tos: ['US', 'GB'],
exclude_froms: ['US', 'GB'],
exclude_tos: ['US', 'GB'],
stages: ['committing', 'expanding'],
signal_types: ['EXEC', 'HIRE'],
signal_strengths: ['high'],
min_signal_count: 3,
only_contraction: false,
domain_search_ids: ['8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c'],
verticals: [123],
vertical_categories: [123],
vertical_sub_categories: [123],
technologies: [123],
employees: [[1, 10], [11, 20], [10001]],
revenues: [0, 100000],
founded_dates: [2018, 2024],
keywords: ['ecommerce', 'ai', 'fintech'],
companies: [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
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'],
advertisement_target_locations: ['TW', 'AE', 'NO'],
advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
advertisement_search_terms: ['asus'],
advertisement_start_dates: ['2025-12-25', '2025-12-25'],
advertisement_end_dates: ['2025-12-25', '2025-12-25'],
news_categories: ['launches'],
news_published_dates: ['2025-01-01', '2025-01-10'],
is_include_established: false,
select_size: 50,
is_include_metadata: true,
is_enable_similarity_search: true
})
};
fetch('https://api.pubrio.com/expansions/companies/rankings', 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/expansions/companies/rankings",
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([
'froms' => [
'US',
'GB'
],
'tos' => [
'US',
'GB'
],
'exclude_froms' => [
'US',
'GB'
],
'exclude_tos' => [
'US',
'GB'
],
'stages' => [
'committing',
'expanding'
],
'signal_types' => [
'EXEC',
'HIRE'
],
'signal_strengths' => [
'high'
],
'min_signal_count' => 3,
'only_contraction' => false,
'domain_search_ids' => [
'8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c'
],
'verticals' => [
123
],
'vertical_categories' => [
123
],
'vertical_sub_categories' => [
123
],
'technologies' => [
123
],
'employees' => [
[
1,
10
],
[
11,
20
],
[
10001
]
],
'revenues' => [
0,
100000
],
'founded_dates' => [
2018,
2024
],
'keywords' => [
'ecommerce',
'ai',
'fintech'
],
'companies' => [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
'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'
],
'advertisement_target_locations' => [
'TW',
'AE',
'NO'
],
'advertisement_exclude_target_locations' => [
'IS',
'GB',
'FR',
'IE',
'ES'
],
'advertisement_search_terms' => [
'asus'
],
'advertisement_start_dates' => [
'2025-12-25',
'2025-12-25'
],
'advertisement_end_dates' => [
'2025-12-25',
'2025-12-25'
],
'news_categories' => [
'launches'
],
'news_published_dates' => [
'2025-01-01',
'2025-01-10'
],
'is_include_established' => false,
'select_size' => 50,
'is_include_metadata' => true,
'is_enable_similarity_search' => true
]),
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/expansions/companies/rankings"
payload := strings.NewReader("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"domain_search_ids\": [\n \"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\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 \"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_search_terms\": [\n \"asus\"\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 \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"is_include_established\": false,\n \"select_size\": 50,\n \"is_include_metadata\": true,\n \"is_enable_similarity_search\": true\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/expansions/companies/rankings")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"domain_search_ids\": [\n \"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\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 \"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_search_terms\": [\n \"asus\"\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 \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"is_include_established\": false,\n \"select_size\": 50,\n \"is_include_metadata\": true,\n \"is_enable_similarity_search\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/companies/rankings")
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 \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"domain_search_ids\": [\n \"8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\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 \"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_search_terms\": [\n \"asus\"\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 \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"is_include_established\": false,\n \"select_size\": 50,\n \"is_include_metadata\": true,\n \"is_enable_similarity_search\": true\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"froms": [
"CN"
],
"tos": [
"GB"
]
},
"select_size": 250,
"count": 1
},
"data": {
"markers": [
{
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
"country_code": "US",
"stage_slug": "expanding",
"expansion_score": 0.721,
"freshness": "fresh",
"direction": "advancing"
}
]
}
}{
"code": 40001,
"message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
"details": {}
}{
"error": "Request rate limit exceeded. Please wait and try again later."
}{
"error": "An unexpected error occurred on the server."
}Autorisierungen
Body
application/json
Ursprungsmärkte (ISO 3166-1 Alpha-2). Von wo aus ein Unternehmen expandiert – seine Heimat-/Hauptsitzländer. Allein verwenden, um Unternehmen zu finden, die aus diesen Märkten heraus wachsen; mit tos kombinieren für einen bestimmten Von-nach-Korridor.
Beispiel:
["US", "GB"]
Zielmärkte (ISO 3166-1 Alpha-2). Wohin ein Unternehmen expandiert. Allein verwenden, um jedes Unternehmen zu finden, das in diese Märkte eintritt; mit froms kombinieren für einen bestimmten Von-nach-Korridor.
Beispiel:
["US", "GB"]
Auszuschließende Ursprungsmärkte (ISO 3166-1 Alpha-2).
Beispiel:
["US", "GB"]
Auszuschließende Zielmärkte (ISO 3166-1 Alpha-2).
Beispiel:
["US", "GB"]
Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.
Verfügbare Optionen:
exploring, committing, expanding, scaling Beispiel:
["committing", "expanding"]
Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.
Verfügbare Optionen:
AD, AUDIENCE, DNS, ENTITY, EVENT, EVENT_PLUS, EXEC, HIRE, INFRA, IP, NEWS, OFFICE, PARTNER, PRODUCT, REG, SCALE, TECH Beispiel:
["EXEC", "HIRE"]
Werte unterscheiden zwischen Groß- und Kleinschreibung und werden nicht validiert. Ein nicht erkannter Wert wird stillschweigend verworfen statt abgelehnt: Bei stages, freshness, scopes und momentum wird der gesamte Filter fallen gelassen, und Sie erhalten ungefilterte Ergebnisse, während bei signal_types und signal_strengths der Filter angewendet wird und nichts trifft. So oder so wirkt die Antwort normal. Lösen Sie gültige Slugs über die Expansion-Referenz auf und vergleichen Sie data.pagination.total_entries mit einem ungefilterten Aufruf, wenn ein Ergebnis falsch erscheint.
Verfügbare Optionen:
low, medium, high, very_high Beispiel:
["high"]
Mindestanzahl an Expansionssignalen, die ein Unternehmen im Zeitraum aufweisen muss — "sehr aktiv / starke Präsenz".
Beispiel:
3
Bei true werden nur als Kontraktion gekennzeichnete Expansionen zurückgegeben (Unternehmen, die sich zurückziehen).
Beispiel:
false
Unternehmen, auf die eingeschränkt werden soll, nach domain_search_id.
Beispiel:
["8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"]
Eine Liste von vertical_id, mit der nach Unternehmen in einer bestimmten Branche oder einem bestimmten Vertical gesucht wird. Die ID finden Sie über den Endpunkt vertical im Filters-Tab.
Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["AI"].
Eine Liste von vertical_category_id, mit der nach Unternehmen in einer bestimmten Vertical-Kategorie gesucht wird. Die ID finden Sie über den Endpunkt vertical category im Filters-Tab.
Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Information Technology"].
Eine Liste von vertical_sub_category_id, mit der nach Unternehmen in einer bestimmten Vertical-Unterkategorie gesucht wird. Die ID finden Sie über den Endpunkt vertical sub category im Filters-Tab.
Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Software"].
Eine Liste von tag_id, mit der nach bestimmten von Unternehmen eingesetzten Technologien gesucht wird. Die ID finden Sie über den Endpunkt technology im Filters-Tab.
Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Shopify"].
Der Zahlenbereich der für das Unternehmen tätigen Mitarbeiter. Damit können Sie Unternehmen anhand der Mitarbeiterzahl finden. Sie können mehrere Bereiche hinzufügen, um Ihre Suchergebnisse zu erweitern.
Weitere Informationen finden Sie über die Endpunkte company size im Filters-Tab.
Beispiel:
[[1, 10], [11, 20], [10001]]
Minimal- und Maximalbereich des Unternehmensumsatzes.
Beispiel:
[0, 100000]
Zeitraum der Unternehmensgründung in Jahren. Der maximale Gründungswert ist das aktuelle Jahr.
Beispiel:
[2018, 2024]
Eine Liste von Stichwörtern, mit der Unternehmen nach Relevanz, Spezialisierung oder Beschreibung gefiltert werden.
Beispiel:
["ecommerce", "ai", "fintech"]
Beschränkt auf bestimmte Unternehmen durch eine beliebige Kombination aus domain_search_id, Unternehmensdomain oder einer URL zum Social-Media-Profil eines Unternehmens. Domains und URLs werden auf das bestplatzierte Unternehmen aufgelöst.
Beispiel:
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
]
ISO 3166-1 Alpha-2 (cca2) wird zum Filtern von Standorten verwendet. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.
Beispiel:
["US", "SG", "CN"]
Geografische Standorte, die von den Stellenanzeigen-Ergebnissen ausgeschlossen werden.
Beispiel:
["CN", "US", "RU", "CA"]
Datumsbereich des Veröffentlichungsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace.
Beispiel:
["2025-01-01", "2025-01-10"]
Berufsbezeichnungen der Personen, die Sie finden möchten.
Die Ergebnisse umfassen auch Berufsbezeichnungen mit ähnlicher Terminologie, selbst wenn diese nicht exakt übereinstimmen. Eine Suche nach software engineer kann beispielsweise Ergebnisse für Personen mit der Bezeichnung senior software engineer liefern.
Beispiel:
["sales manager", "marketing manager"]
Geografische Zielstandorte für Anzeigen.
Beispiel:
["TW", "AE", "NO"]
Geografische Standorte, die vom Anzeigen-Targeting ausgeschlossen werden.
Beispiel:
["IS", "GB", "FR", "IE", "ES"]
Stichwörter zur Suche innerhalb von Anzeigeninhalten oder -titeln.
Beispiel:
["asus"]
Startdatumsbereich für die Anzeigenfilterung.
Beispiel:
["2025-12-25", "2025-12-25"]
Enddatumsbereich für die Anzeigenfilterung.
Beispiel:
["2025-12-25", "2025-12-25"]
Liste von category slugs zur Suche nach bestimmten News-Kategorien. Den Slug finden Sie über den Endpunkt news categories im Filters-Tab.
Beispiel:
["launches"]
Datumsbereich des Publikationsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace.
Beispiel:
["2025-01-01", "2025-01-10"]
Schließt die Stufe established ein (langjährige Anbieter ohne aktive Expansionssignale). Standardmäßig false.
Beispiel:
false
Maximale Anzahl zurückzugebender Datensätze. Durch Ihren Tarif begrenzt.
Beispiel:
50
Gibt die vollständige Detail-Payload zurück. API-Schlüssel-Traffic ist standardmäßig schlank: Der model-Block, die Konfidenzwerte (stage.confidence bei Company Expansion Detail, confidence_score bei other_markets[] und bei Rankings markers[]) sowie die Felder established_min / share_of_detected / has_known_office werden alle weggelassen, sofern dies nicht true ist.
Beispiel:
true
Aktiviert Freitext-Matching für verticals, vertical_categories, vertical_sub_categories und technologies; diese Filter werden fallen gelassen, sofern dies nicht true ist.
Beispiel:
true
Zuletzt geändert am 4. September 2026