Classements d'expansion
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
Classements d'expansion
Liste classée et légère de couples entreprise/marché selon le score d’expansion — adaptée au rendu sous forme de carte ou de carte de chaleur.
POST
/
expansions
/
companies
/
rankings
Classements d'expansion
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."
}Autorisations
Corps
application/json
Marchés d'origine (ISO 3166-1 alpha-2). D'où une entreprise se développe (FROM) — ses pays domestiques / de siège social. À utiliser seul pour trouver les entreprises se développant à partir de ces marchés ; combinez avec tos pour un corridor from→to spécifique.
Exemple:
["US", "GB"]
Marchés cibles (ISO 3166-1 alpha-2). Vers où une entreprise se développe (TO). À utiliser seul pour trouver toutes les entreprises entrant sur ces marchés ; combinez avec froms pour un corridor from→to spécifique.
Exemple:
["US", "GB"]
Marchés d'origine à exclure (ISO 3166-1 alpha-2).
Exemple:
["US", "GB"]
Marchés cibles à exclure (ISO 3166-1 alpha-2).
Exemple:
["US", "GB"]
Les valeurs sont sensibles à la casse et ne sont pas validées. Une valeur non reconnue est silencieusement ignorée plutôt que rejetée : sur stages, freshness, scopes et momentum, tout le filtre est abandonné et vous obtenez des résultats non filtrés, tandis que sur signal_types et signal_strengths, le filtre est appliqué et ne correspond à rien. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides à partir de Expansion Reference et comparez data.pagination.total_entries à un appel non filtré si un ensemble de résultats semble incorrect.
Options disponibles:
exploring, committing, expanding, scaling Exemple:
["committing", "expanding"]
Les valeurs sont sensibles à la casse et ne sont pas validées. Une valeur non reconnue est silencieusement ignorée plutôt que rejetée : sur stages, freshness, scopes et momentum, tout le filtre est abandonné et vous obtenez des résultats non filtrés, tandis que sur signal_types et signal_strengths, le filtre est appliqué et ne correspond à rien. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides à partir de Expansion Reference et comparez data.pagination.total_entries à un appel non filtré si un ensemble de résultats semble incorrect.
Options disponibles:
AD, AUDIENCE, DNS, ENTITY, EVENT, EVENT_PLUS, EXEC, HIRE, INFRA, IP, NEWS, OFFICE, PARTNER, PRODUCT, REG, SCALE, TECH Exemple:
["EXEC", "HIRE"]
Les valeurs sont sensibles à la casse et ne sont pas validées. Une valeur non reconnue est silencieusement ignorée plutôt que rejetée : sur stages, freshness, scopes et momentum, tout le filtre est abandonné et vous obtenez des résultats non filtrés, tandis que sur signal_types et signal_strengths, le filtre est appliqué et ne correspond à rien. Dans les deux cas, la réponse semble normale. Résolvez les slugs valides à partir de Expansion Reference et comparez data.pagination.total_entries à un appel non filtré si un ensemble de résultats semble incorrect.
Options disponibles:
low, medium, high, very_high Exemple:
["high"]
Nombre minimal de signaux d'expansion qu'une entreprise doit avoir dans la fenêtre — « très active / forte empreinte ».
Exemple:
3
Lorsque true, ne renvoie que les expansions marquées comme contraction (entreprises en repli).
Exemple:
false
Entreprises auxquelles restreindre la recherche, par domain_search_id.
Exemple:
["8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"]
Une liste de vertical_id utilisée pour rechercher des entreprises dans un secteur ou une verticale spécifique. Pour trouver l'ID, appelez le point de terminaison vertical sous l'onglet Filters.
Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["AI"].
Une liste de vertical_category_id utilisée pour rechercher des entreprises dans une catégorie verticale spécifique. Pour trouver l'ID, appelez le point de terminaison vertical category sous l'onglet Filters.
Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["Information Technology"].
Une liste de vertical_sub_category_id utilisée pour rechercher des entreprises dans une sous-catégorie verticale spécifique. Pour trouver l'ID, appelez le point de terminaison vertical sub category sous l'onglet Filters.
Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["Software"].
Une liste de tag_id utilisée pour rechercher des technologies spécifiques utilisées par les entreprises. Pour trouver l'ID, appelez le point de terminaison technology sous l'onglet Filters.
Ce filtre prend en charge is_enable_similarity_search ; une fois activé, vous pouvez saisir n'importe quel texte libre, par ex. ["Shopify"].
La plage numérique d'employés travaillant pour l'entreprise. Cela vous permet de trouver des entreprises en fonction de leur effectif. Vous pouvez ajouter plusieurs plages pour élargir vos résultats de recherche.
Consultez les points de terminaison company size sous l'onglet Filters pour plus d'informations.
Exemple:
[[1, 10], [11, 20], [10001]]
Plage minimale et maximale du chiffre d'affaires de l'entreprise.
Exemple:
[0, 100000]
Plage d'années de fondation de l'entreprise. La valeur maximale de fondation est l'année en cours.
Exemple:
[2018, 2024]
Une liste de mots-clés pour filtrer les entreprises par pertinence, spécialités ou descriptions.
Exemple:
["ecommerce", "ai", "fintech"]
Limite à des entreprises spécifiques via n'importe quelle combinaison de domain_search_id, de domaine d'entreprise, ou d'URL de profil de réseau social d'entreprise. Les domaines et URL sont résolus vers leur entreprise la mieux classée.
Exemple:
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
]
Le code ISO 3166-1 alpha-2 (cca2) est utilisé pour filtrer les localisations. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.
Exemple:
["US", "SG", "CN"]
Localisations géographiques à exclure des résultats d'offres d'emploi.
Exemple:
["CN", "US", "RU", "CA"]
Plage de dates de la date de publication. La valeur maximale est le jour en cours. Les limites de journée suivent le fuseau horaire de votre espace de travail.
Exemple:
["2025-01-01", "2025-01-10"]
Intitulés de poste associés aux personnes que vous cherchez à localiser.
Les résultats incluront également les intitulés de poste comportant une terminologie similaire, même s'ils ne correspondent pas exactement. Par exemple, une recherche pour software engineer peut renvoyer des résultats pour des personnes portant le titre senior software engineer.
Exemple:
["sales manager", "marketing manager"]
Localisations géographiques cibles pour les publicités.
Exemple:
["TW", "AE", "NO"]
Localisations géographiques à exclure du ciblage publicitaire.
Exemple:
["IS", "GB", "FR", "IE", "ES"]
Mots-clés utilisés pour rechercher dans le contenu ou les titres des publicités.
Exemple:
["asus"]
Plage de dates de début pour le filtrage des publicités.
Exemple:
["2025-12-25", "2025-12-25"]
Plage de dates de fin pour le filtrage des publicités.
Exemple:
["2025-12-25", "2025-12-25"]
Liste de category slugs pour rechercher des catégories d'actualités spécifiques. Pour trouver un slug, appelez le point de terminaison news categories sous l'onglet Filters.
Exemple:
["launches"]
Plage de dates de la date de publication. La valeur maximale est le jour en cours. Les limites de journée suivent le fuseau horaire de votre espace de travail.
Exemple:
["2025-01-01", "2025-01-10"]
Inclut l'étape established (acteurs établis de longue date sans signaux d'expansion actifs). Par défaut à false.
Exemple:
false
Nombre maximal d'enregistrements à renvoyer. Plafonné selon votre forfait.
Exemple:
50
Renvoie la charge utile détaillée complète. Le trafic par clé API est allégé par défaut : le bloc model, les indices de confiance (stage.confidence sur Company Expansion Detail, confidence_score sur other_markets[] et sur les markers[] des classements) ainsi que les champs established_min / share_of_detected / has_known_office sont tous omis sauf si ce paramètre vaut true.
Exemple:
true
Active la correspondance en texte libre pour verticals, vertical_categories, vertical_sub_categories et technologies ; ces filtres sont abandonnés sauf si ce paramètre vaut true.
Exemple:
true
Dernière modification le 4 septembre 2026