Recherche d'expansion

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."
}

POST

expansions

Recherche d'expansion

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."
}

Autorisations

pubrio-api-key

string

header

requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json

From Markets
To Markets
Plain-language Query
Companies

froms

string[]

requis

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"]

tos

string[]

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"]

exclude_froms

string[]

Marchés d'origine à exclure (ISO 3166-1 alpha-2).

Exemple:

["US", "GB"]

exclude_tos

string[]

Marchés cibles à exclure (ISO 3166-1 alpha-2).

Exemple:

["US", "GB"]

stages

enum<string>[]

Les valeurs sont sensibles à la casse et ne sont pas validées. Une valeur non reconnue est abandonnée silencieusement 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 depuis Expansion Reference et comparez data.pagination.total_entries à un appel non filtré si un jeu de résultats semble incorrect.

Options disponibles:

exploring,

committing,

expanding,

scaling

Exemple:

["committing", "expanding"]

momentum

enum<string>[]

Trajectoire du mouvement de l'entreprise sur le marché. advancing gagne du terrain, steady se maintient, pulling_back couvre le repli et la contraction.

N'utilisez pas ici les valeurs de directions dans Expansion Reference. Celles-ci (advancing, steady, retreating, new) sont les valeurs de réponse que vous obtenez sur stage.direction ; seules les trois listées ci-dessus sont acceptées comme filtre. Envoyer retreating ou new désactive silencieusement le filtre et renvoie des résultats non filtrés.

Options disponibles:

advancing,

steady,

pulling_back

Exemple:

["advancing", "steady"]

freshness

enum<string>[]

Options disponibles:

fresh,

cooling,

stale,

cold

Exemple:

["fresh", "cooling"]

scopes

enum<string>[]

Filtre selon l'ampleur de l'entrée sur le marché.

Options disponibles:

entering_new_market,

expanding_within_presence,

established_only

Exemple:

["entering_new_market"]

ahead_of_pace

boolean

Limiter aux paires évoluant plus vite que le rythme typique de ce marché.

Exemple:

false

signal_types

enum<string>[]

Options disponibles:

AD,

AUDIENCE,

DNS,

ENTITY,

EVENT,

EVENT_PLUS,

EXEC,

HIRE,

INFRA,

IP,

NEWS,

OFFICE,

PARTNER,

PRODUCT,

REG,

SCALE,

TECH

Exemple:

["EXEC", "HIRE"]

signal_strengths

enum<string>[]

Options disponibles:

low,

medium,

high,

very_high

Exemple:

["high"]

min_signal_count

integer

Nombre minimum de signaux d'expansion qu'une entreprise doit avoir dans la fenêtre — « très active / forte empreinte ».

Exemple:

3

only_contraction

boolean

Lorsque true, ne renvoie que les expansions marquées comme contraction (entreprises en repli).

Exemple:

false

min_markets

integer

Nombre minimum de nouveaux marchés qu'une entreprise doit avoir intégrés dans la fenêtre.

Exemple:

3

home_country_code

string[]

Filtrer par pays d'origine de l'entreprise (ISO 3166-1 alpha-2). Se combine avec froms lorsque les deux sont fournis.

Exemple:

["SG"]

industries

string[]

Filtre selon le nom du secteur (correspondance en texte libre).

Exemple:

["software", "financial services"]

exclude_industries

string[]

Secteurs à exclure (correspondance en texte libre).

Exemple:

["tobacco"]

verticals

integer[]

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"].

vertical_categories

integer[]

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"].

vertical_sub_categories

integer[]

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"].

technologies

integer[]

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"].

employees

string[][]

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]]

revenues

integer[]

Plage minimale et maximale du chiffre d'affaires de l'entreprise.

Exemple:

[0, 100000]

founded_dates

integer[]

Plage d'années de fondation de l'entreprise. La valeur maximale de fondation est l'année en cours.

Exemple:

[2018, 2024]

keywords

string[]

Une liste de mots-clés pour filtrer les entreprises par pertinence, spécialités ou descriptions.

Exemple:

["ecommerce", "ai", "fintech"]

companies

string[]

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"
]

job_locations

string[]

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"]

job_exclude_locations

string[]

Localisations géographiques à exclure des résultats d'offres d'emploi.

Exemple:

["CN", "US", "RU", "CA"]

job_posted_dates

string[]

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"]

job_titles

string[]

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"]

advertisement_target_locations

string[]

Localisations géographiques cibles pour les publicités.

Exemple:

["TW", "AE", "NO"]

advertisement_exclude_target_locations

string[]

Localisations géographiques à exclure du ciblage publicitaire.

Exemple:

["IS", "GB", "FR", "IE", "ES"]

advertisement_search_terms

string[]

Mots-clés utilisés pour rechercher dans le contenu ou les titres des publicités.

Exemple:

["asus"]

advertisement_start_dates

string<date>[]

Plage de dates de début pour le filtrage des publicités.

Exemple:

["2025-12-25", "2025-12-25"]

advertisement_end_dates

string<date>[]

Plage de dates de fin pour le filtrage des publicités.

Exemple:

["2025-12-25", "2025-12-25"]

news_categories

string[]

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"]

news_published_dates

string[]

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"]

transitioned_dates

string<date>[]

Plage de dates ISO pour la fenêtre de chronologie. Par défaut sur les 90 derniers jours. Une query en langage naturel peut aussi définir cela à partir d'expressions calendaires (« cette année », « l'année dernière », « T2 2026 »).

Exemple:

["2026-04-01", "2026-06-29"]

window_days

integer

Facultatif. Taille de la fenêtre glissante, en jours. Utilisée lorsqu'une plage transitioned_dates explicite n'est pas fournie ; si les deux sont omis, une fenêtre par défaut est utilisée.

Exemple:

90

query

string

Requête en langage naturel que Pubrio interprète en filtres d'expansion + d'entreprise.

Exemple:

"fintech companies expanding into the UK"

is_explain_match

boolean

Inclut des explications générées par IA sur la raison pour laquelle chaque entreprise correspond à la recherche, ancrées dans les signaux réels de l'entreprise. Fonctionne mieux avec une requête en langage naturel. Le nombre de signaux cités et la taille du lot évoluent tous deux avec per_page ; les sources à fort volume (offres d'emploi, campagnes publicitaires) sont résumées sous forme de comptage sur la fenêtre (par ex. « 12 offres d'emploi ») plutôt que listées individuellement.

Exemple:

true

sort_by

enum<string>

Ordre des résultats. Omettez pour l'ordre de pertinence par défaut : les couples corroborés en premier (2 types de signaux distincts ou plus), puis les couples à preuves répétées (3 signaux ou plus), puis le reste — les plus récemment transitionnés en premier au sein de chaque palier. recent — pure récence (les plus récemment transitionnés en premier). expansion_score — le score d'expansion le plus élevé en premier. signal_count — le plus grand nombre de signaux dans le couple en premier. company_ranking — classement global de l'entreprise selon Pubrio (plus bas signifie plus important), par ordre croissant.

Options disponibles:

recent,

expansion_score,

signal_count,

company_ranking

Exemple:

"expansion_score"

is_include_metadata

boolean

Renvoie la charge utile de détail complète. Le trafic par clé API est allégé par défaut : le bloc model, les chiffres de confiance (stage.confidence sur Company Expansion Detail, confidence_score sur other_markets[] et sur markers[] de Rankings) et les champs established_min / share_of_detected / has_known_office sont tous omis sauf si ceci est true.

Exemple:

true

page

integer

défaut:1

Numéro de page, à partir de 1. Le plafond correspond au max_search_page de votre abonnement (max_company_search_page pour la recherche d'entreprises), renvoyé par Profile. Le dépasser renvoie HTTP 416.

Exemple:

1

per_page

integer

défaut:25

Enregistrements par page. Par défaut 25, ce qui constitue également le plafond sur la plupart des forfaits — la limite correspond au max_search_per_page de votre abonnement, renvoyé par Profile. Le dépasser renvoie HTTP 416 avec le code 41676 (ou 41613 pour la recherche d'entreprises et de personnes), et non un ensemble de résultats tronqué.

Plage requise: x <= 25

Exemple:

25

is_enable_similarity_search

boolean

Active la correspondance en texte libre pour verticals, vertical_categories, vertical_sub_categories et technologies ; ces filtres sont abandonnés sauf si ceci est true.

Exemple:

true

Réponse

Liste paginée d'entreprises s'étendant sur le(s) marché(s). filters reflète les critères appliqués (ou interprétés en langage naturel) ; chaque entreprise inclut un match_summary quand is_explain_match est true.

metadata

object

Métadonnées de recherche : les filtres réellement appliqués, plus l'agrégat de marché (agrégat, portée géographique, principales origines/destinations/secteurs, chronologie). Les réponses par clé API n'incluent l'agrégat que lorsque is_include_metadata est true.

Show child attributes

data

object

Conteneur de résultat (enveloppe de recherche standard) : la liste d'entreprises plus la pagination.

Show child attributes

Dernière modification le 4 septembre 2026

Documentation API

Point de terminaison

Recherche d'expansion

Autorisations

Corps

Réponse