curl --request POST \
--url https://api.pubrio.com/expansions/search \
--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"
],
"momentum": [
"advancing",
"steady"
],
"freshness": [
"fresh",
"cooling"
],
"scopes": [
"entering_new_market"
],
"ahead_of_pace": false,
"signal_types": [
"EXEC",
"HIRE"
],
"signal_strengths": [
"high"
],
"min_signal_count": 3,
"only_contraction": false,
"min_markets": 3,
"home_country_code": [
"SG"
],
"industries": [
"software",
"financial services"
],
"exclude_industries": [
"tobacco"
],
"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"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": true,
"sort_by": "expansion_score",
"is_include_metadata": true,
"page": 1,
"per_page": 25,
"is_enable_similarity_search": true
}
'import requests
url = "https://api.pubrio.com/expansions/search"
payload = {
"froms": ["US", "GB"],
"tos": ["US", "GB"],
"exclude_froms": ["US", "GB"],
"exclude_tos": ["US", "GB"],
"stages": ["committing", "expanding"],
"momentum": ["advancing", "steady"],
"freshness": ["fresh", "cooling"],
"scopes": ["entering_new_market"],
"ahead_of_pace": False,
"signal_types": ["EXEC", "HIRE"],
"signal_strengths": ["high"],
"min_signal_count": 3,
"only_contraction": False,
"min_markets": 3,
"home_country_code": ["SG"],
"industries": ["software", "financial services"],
"exclude_industries": ["tobacco"],
"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"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": True,
"sort_by": "expansion_score",
"is_include_metadata": True,
"page": 1,
"per_page": 25,
"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'],
momentum: ['advancing', 'steady'],
freshness: ['fresh', 'cooling'],
scopes: ['entering_new_market'],
ahead_of_pace: false,
signal_types: ['EXEC', 'HIRE'],
signal_strengths: ['high'],
min_signal_count: 3,
only_contraction: false,
min_markets: 3,
home_country_code: ['SG'],
industries: ['software', 'financial services'],
exclude_industries: ['tobacco'],
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'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
query: 'fintech companies expanding into the UK',
is_explain_match: true,
sort_by: 'expansion_score',
is_include_metadata: true,
page: 1,
per_page: 25,
is_enable_similarity_search: true
})
};
fetch('https://api.pubrio.com/expansions/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/expansions/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([
'froms' => [
'US',
'GB'
],
'tos' => [
'US',
'GB'
],
'exclude_froms' => [
'US',
'GB'
],
'exclude_tos' => [
'US',
'GB'
],
'stages' => [
'committing',
'expanding'
],
'momentum' => [
'advancing',
'steady'
],
'freshness' => [
'fresh',
'cooling'
],
'scopes' => [
'entering_new_market'
],
'ahead_of_pace' => false,
'signal_types' => [
'EXEC',
'HIRE'
],
'signal_strengths' => [
'high'
],
'min_signal_count' => 3,
'only_contraction' => false,
'min_markets' => 3,
'home_country_code' => [
'SG'
],
'industries' => [
'software',
'financial services'
],
'exclude_industries' => [
'tobacco'
],
'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'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'query' => 'fintech companies expanding into the UK',
'is_explain_match' => true,
'sort_by' => 'expansion_score',
'is_include_metadata' => true,
'page' => 1,
'per_page' => 25,
'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/search"
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 \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\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 \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\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/search")
.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 \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\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 \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/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 \"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 \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\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 \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"tos": [
"GB"
],
"verticals": [
"Financial Services"
]
}
},
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 87,
"total_pages": 4,
"total_display_pages": 4,
"is_timeout": false
},
"companies": [
{
"expansion_id": "6845525",
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
"country_code": "GB",
"target_country_code": "GB",
"domain": "example.com",
"company_name": "Example Corp",
"home_country_code": "CN",
"industry": "Consumer Electronics",
"founded_year": 2015,
"employees_count": 320,
"stage": {
"slug": "expanding",
"expansion_score": 0.72,
"scope": "entering_new_market",
"direction": "advancing",
"freshness": "fresh",
"signal_count": 27,
"distinct_type_count": 3,
"last_transition_at": "2026-06-27T14:32:10.000Z"
},
"presence": {
"level": "established",
"local_people_count": 12,
"matched_rule": "headcount",
"has_known_office": true,
"established_min": 10,
"share_of_detected": 0.54
},
"read": {
"code": "establishing"
}
}
]
}
}{
"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."
}البحث في التوسع
اعثر على شركات تتوسع إلى سوق واحدة أو أكثر باستخدام مرشحات وصفية للشركة والإشارة أو استعلام بلغة طبيعية، مع تفسيرات مطابقة اختيارية بالذكاء الاصطناعي مستندة إلى الإشارات الحقيقية لكل شركة.
curl --request POST \
--url https://api.pubrio.com/expansions/search \
--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"
],
"momentum": [
"advancing",
"steady"
],
"freshness": [
"fresh",
"cooling"
],
"scopes": [
"entering_new_market"
],
"ahead_of_pace": false,
"signal_types": [
"EXEC",
"HIRE"
],
"signal_strengths": [
"high"
],
"min_signal_count": 3,
"only_contraction": false,
"min_markets": 3,
"home_country_code": [
"SG"
],
"industries": [
"software",
"financial services"
],
"exclude_industries": [
"tobacco"
],
"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"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": true,
"sort_by": "expansion_score",
"is_include_metadata": true,
"page": 1,
"per_page": 25,
"is_enable_similarity_search": true
}
'import requests
url = "https://api.pubrio.com/expansions/search"
payload = {
"froms": ["US", "GB"],
"tos": ["US", "GB"],
"exclude_froms": ["US", "GB"],
"exclude_tos": ["US", "GB"],
"stages": ["committing", "expanding"],
"momentum": ["advancing", "steady"],
"freshness": ["fresh", "cooling"],
"scopes": ["entering_new_market"],
"ahead_of_pace": False,
"signal_types": ["EXEC", "HIRE"],
"signal_strengths": ["high"],
"min_signal_count": 3,
"only_contraction": False,
"min_markets": 3,
"home_country_code": ["SG"],
"industries": ["software", "financial services"],
"exclude_industries": ["tobacco"],
"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"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": True,
"sort_by": "expansion_score",
"is_include_metadata": True,
"page": 1,
"per_page": 25,
"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'],
momentum: ['advancing', 'steady'],
freshness: ['fresh', 'cooling'],
scopes: ['entering_new_market'],
ahead_of_pace: false,
signal_types: ['EXEC', 'HIRE'],
signal_strengths: ['high'],
min_signal_count: 3,
only_contraction: false,
min_markets: 3,
home_country_code: ['SG'],
industries: ['software', 'financial services'],
exclude_industries: ['tobacco'],
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'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
query: 'fintech companies expanding into the UK',
is_explain_match: true,
sort_by: 'expansion_score',
is_include_metadata: true,
page: 1,
per_page: 25,
is_enable_similarity_search: true
})
};
fetch('https://api.pubrio.com/expansions/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/expansions/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([
'froms' => [
'US',
'GB'
],
'tos' => [
'US',
'GB'
],
'exclude_froms' => [
'US',
'GB'
],
'exclude_tos' => [
'US',
'GB'
],
'stages' => [
'committing',
'expanding'
],
'momentum' => [
'advancing',
'steady'
],
'freshness' => [
'fresh',
'cooling'
],
'scopes' => [
'entering_new_market'
],
'ahead_of_pace' => false,
'signal_types' => [
'EXEC',
'HIRE'
],
'signal_strengths' => [
'high'
],
'min_signal_count' => 3,
'only_contraction' => false,
'min_markets' => 3,
'home_country_code' => [
'SG'
],
'industries' => [
'software',
'financial services'
],
'exclude_industries' => [
'tobacco'
],
'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'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'query' => 'fintech companies expanding into the UK',
'is_explain_match' => true,
'sort_by' => 'expansion_score',
'is_include_metadata' => true,
'page' => 1,
'per_page' => 25,
'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/search"
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 \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\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 \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\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/search")
.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 \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\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 \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/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 \"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 \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\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 \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"tos": [
"GB"
],
"verticals": [
"Financial Services"
]
}
},
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 87,
"total_pages": 4,
"total_display_pages": 4,
"is_timeout": false
},
"companies": [
{
"expansion_id": "6845525",
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
"country_code": "GB",
"target_country_code": "GB",
"domain": "example.com",
"company_name": "Example Corp",
"home_country_code": "CN",
"industry": "Consumer Electronics",
"founded_year": 2015,
"employees_count": 320,
"stage": {
"slug": "expanding",
"expansion_score": 0.72,
"scope": "entering_new_market",
"direction": "advancing",
"freshness": "fresh",
"signal_count": 27,
"distinct_type_count": 3,
"last_transition_at": "2026-06-27T14:32:10.000Z"
},
"presence": {
"level": "established",
"local_people_count": 12,
"matched_rule": "headcount",
"has_known_office": true,
"established_min": 10,
"share_of_detected": 0.54
},
"read": {
"code": "establishing"
}
}
]
}
}{
"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."
}التفويضات
الجسم
- From Markets
- To Markets
- Plain-language Query
- Companies
أسواق المنشأ (ISO 3166-1 alpha-2). من أين تتوسع شركة — دولها الأصلية/مقرها. استخدمها وحدها لإيجاد شركات تنمو خارج هذه الأسواق؛ اجمعها مع tos لممر محدد من→إلى.
["US", "GB"]
الأسواق المستهدفة (ISO 3166-1 alpha-2). إلى أين تتوسع شركة. استخدمها وحدها لإيجاد كل شركة تدخل هذه الأسواق؛ اجمعها مع froms لممر محدد من→إلى.
["US", "GB"]
أسواق المنشأ المستبعدة (ISO 3166-1 alpha-2).
["US", "GB"]
الأسواق المستهدفة المستبعدة (ISO 3166-1 alpha-2).
["US", "GB"]
القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.
exploring, committing, expanding, scaling ["committing", "expanding"]
مسار تحرك الشركة في السوق. advancing يعني كسب أرض، وsteady يعني الثبات، وpulling_back يغطي التراجع والانكماش.
لا تستخدم القيم من directions في مرجع التوسع هنا. تلك (advancing، steady، retreating، new) هي قيم الاستجابة التي تحصل عليها في stage.direction؛ فقط الثلاث المذكورة أعلاه مقبولة كمرشح. إرسال retreating أو new يعطّل المرشح بصمت ويُعيد نتائج غير مصفّاة.
advancing, steady, pulling_back ["advancing", "steady"]
القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.
fresh, cooling, stale, cold ["fresh", "cooling"]
التصفية حسب نطاق دخول السوق.
entering_new_market, expanding_within_presence, established_only ["entering_new_market"]
التحديد للأزواج المتحركة أسرع من الوتيرة المعتادة لذلك السوق.
false
القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.
AD, AUDIENCE, DNS, ENTITY, EVENT, EVENT_PLUS, EXEC, HIRE, INFRA, IP, NEWS, OFFICE, PARTNER, PRODUCT, REG, SCALE, TECH ["EXEC", "HIRE"]
القيم حساسة لحالة الأحرف ولا تُتحقَّق منها. تُهمَل القيمة غير المعروفة بصمت بدلًا من رفضها: في stages وfreshness وscopes وmomentum يُسقَط المرشح بأكمله وتحصل على نتائج غير مصفّاة، بينما في signal_types وsignal_strengths يُطبَّق المرشح ولا يطابق شيئًا. في الحالتين تبدو الاستجابة عادية. احصل على الأسماء القياسية الصالحة من مرجع التوسع وقارن data.pagination.total_entries مع استدعاء غير مصفّى إن بدت مجموعة النتائج خاطئة.
low, medium, high, very_high ["high"]
الحد الأدنى لعدد إشارات التوسع التي يجب أن تملكها شركة ضمن النافذة — "نشطة جدًا / بصمة ثقيلة".
3
عند true، أعِد فقط التوسعات الموسومة بالانكماش (الشركات المتقلصة).
false
الحد الأدنى لعدد الأسواق الجديدة التي يجب أن تكون شركة قد دخلتها ضمن النافذة.
3
التصفية حسب دولة مقر الشركة (ISO 3166-1 alpha-2). تتقاطع مع froms عند توفير كليهما.
["SG"]
التصفية حسب اسم الصناعة (مطابقة نص حر).
["software", "financial services"]
الصناعات المستبعدة (مطابقة نص حر).
["tobacco"]
قائمة من vertical_id تُستخدَم للبحث عن شركات في قطاع أو صناعة محددة. لإيجاد المعرّف، استدعِ نقطة vertical تحت تبويب Filters.
يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["AI"].
قائمة من vertical_category_id تُستخدَم للبحث عن شركات في فئة قطاع محددة. لإيجاد المعرّف، استدعِ نقطة vertical category تحت تبويب Filters.
يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Information Technology"].
قائمة من vertical_sub_category_id تُستخدَم للبحث عن شركات في فئة فرعية محددة لقطاع. لإيجاد المعرّف، استدعِ نقطة vertical sub category تحت تبويب Filters.
يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Software"].
قائمة من tag_id تُستخدَم للبحث عن تقنيات محددة تستخدمها الشركات. لإيجاد المعرّف، استدعِ نقطة technology تحت تبويب Filters.
يدعم هذا المرشح is_enable_similarity_search، وبمجرد تفعيله يمكنك إدخال أي نص حر، مثل ["Shopify"].
نطاق عدد الموظفين العاملين في الشركة. يتيح لك هذا إيجاد شركات بناءً على عدد الموظفين. يمكنك إضافة نطاقات متعددة لتوسيع نتائج بحثك.
راجع نقاط company size تحت تبويب Filters لمزيد من المعلومات.
[[1, 10], [11, 20], [10001]]
الحد الأدنى والأقصى لنطاق إيرادات الشركة.
[0, 100000]
نطاق سنوات تأسيس الشركة. القيمة القصوى للتأسيس هي السنة الحالية.
[2018, 2024]
قائمة من الكلمات المفتاحية لتصفية الشركات حسب الصلة، أو التخصصات، أو الأوصاف.
["ecommerce", "ai", "fintech"]
التحديد لشركات محددة عبر أي مزيج من domain_search_id، أو نطاق الشركة، أو رابط ملف شركة على وسائل التواصل الاجتماعي. تُحل النطاقات والروابط إلى أفضل شركة مطابقة مرتبة.
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
]
يُستخدَم ISO 3166-1 alpha-2 (cca2) لتصفية المواقع. راجع نقاط location تحت تبويب Filters لمزيد من المعلومات.
["US", "SG", "CN"]
المواقع الجغرافية المستبعدة من نتائج إعلانات الوظائف.
["CN", "US", "RU", "CA"]
نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك.
["2025-01-01", "2025-01-10"]
المسميات الوظيفية المرتبطة بالأفراد الذين تهدف إلى تحديدهم.
ستشمل النتائج أيضًا مسميات وظيفية تحتوي مصطلحات مشابهة، حتى لو لم تطابق تمامًا. مثلًا، البحث عن software engineer قد يُظهر نتائج لأفراد بمسمى senior software engineer.
["sales manager", "marketing manager"]
المواقع الجغرافية المستهدفة للإعلانات.
["TW", "AE", "NO"]
المواقع الجغرافية المستبعدة من استهداف الإعلانات.
["IS", "GB", "FR", "IE", "ES"]
كلمات مفتاحية تُستخدَم للبحث ضمن محتوى الإعلان أو عناوينه.
["asus"]
نطاق تاريخ البداية لتصفية الإعلانات.
["2025-12-25", "2025-12-25"]
نطاق تاريخ النهاية لتصفية الإعلانات.
["2025-12-25", "2025-12-25"]
قائمة من category slugs للبحث عن فئات أخبار محددة. لإيجاد اسم قياسي، استدعِ نقطة news categories تحت تبويب Filters.
["launches"]
نطاق تاريخ تاريخ النشر. القيمة القصوى هي اليوم الحالي. تتبع حدود اليوم توقيت منطقة عمل حسابك.
["2025-01-01", "2025-01-10"]
نطاق تاريخ ISO لنافذة الجدول الزمني. الافتراضي آخر 90 يومًا. يمكن لاستعلام query بلغة طبيعية أيضًا ضبط هذا من عبارات تقويمية ("هذا العام"، "العام الماضي"، "الربع الثاني 2026").
["2026-04-01", "2026-06-29"]
اختياري. حجم النافذة المتحركة بالأيام. يُستخدَم عندما لا يُوفَّر نطاق transitioned_dates صريح؛ إن حُذف كلاهما، تُستخدَم نافذة افتراضية.
90
استعلام بلغة طبيعية يفسّره Pubrio إلى مرشحات توسع + شركة.
"fintech companies expanding into the UK"
أدرِج تفسيرات مولَّدة بالذكاء الاصطناعي لسبب مطابقة كل شركة للبحث، مستندة إلى الإشارات الحقيقية للشركة. الأنسب مع استعلام بلغة طبيعية. يتناسب عدد الإشارات المُستشهَد بها وحجم الدفعة مع per_page؛ تُلخَّص المصادر عالية الحجم (إعلانات الوظائف، الحملات الإعلانية) كعدد محدَّد بنافذة (مثل "12 إعلان وظيفة") بدلًا من سردها فرديًا.
true
ترتيب النتائج. اتركه فارغًا لترتيب الصلة الافتراضي: الأزواج المدعَّمة أولًا (نوعا إشارة مميزان أو أكثر)، ثم أزواج الأدلة المتكررة (3 إشارات أو أكثر)، ثم البقية — الأحدث انتقالًا أولًا ضمن كل مستوى. recent — الحداثة الصرفة (الأحدث انتقالًا أولًا). expansion_score — أعلى درجة توسع أولًا. signal_count — أكثر إشارات في الزوج أولًا. company_ranking — ترتيب Pubrio الإجمالي للشركة (الأدنى أبرز)، تصاعديًا.
recent, expansion_score, signal_count, company_ranking "expansion_score"
أعِد حمولة التفاصيل الكاملة. حركة مرور مفتاح API مختصرة افتراضيًا: تُحذَف كتلة model، وأرقام الثقة (stage.confidence في تفاصيل توسع الشركة، وconfidence_score في other_markets[] وفي markers[] الخاصة بالتصنيفات)، وحقول established_min / share_of_detected / has_known_office ما لم تكن هذه بقيمة true.
true
فعّل المطابقة بالنص الحر لـ verticals وvertical_categories وvertical_sub_categories وtechnologies؛ تُسقَط تلك المرشحات ما لم تكن هذه بقيمة true.
true
الاستجابة
قائمة مرقّمة صفحيًا من الشركات المتوسعة في السوق (الأسواق). تعرض filters المعايير المطبَّقة (أو المفسَّرة من اللغة الطبيعية)؛ تتضمن كل شركة match_summary عندما تكون is_explain_match بقيمة true.
بيانات وصفية للبحث: المرشحات المطبَّقة فعليًا، بالإضافة إلى تجميع السوق (الإجمالي، النطاق الجغرافي، أهم المصادر/الوجهات/الصناعات، الجدول الزمني). تتضمن استجابات مفتاح API التجميع فقط عندما تكون is_include_metadata بقيمة true.
Show child attributes
Show child attributes
حاوية النتائج (غلاف البحث القياسي): قائمة الشركات بالإضافة إلى الترقيم الصفحي.
Show child attributes
Show child attributes

