Aperçu de l'expansion

Vue d'ensemble Expansion

curl --request POST \
  --url https://api.pubrio.com/expansions/dashboard \
  --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,
  "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-06-01",
    "2026-06-29"
  ],
  "window_days": 90,
  "min_markets": 3,
  "home_country_code": [
    "SG"
  ],
  "industries": [
    "software",
    "financial services"
  ],
  "exclude_industries": [
    "tobacco"
  ],
  "select_size": 250,
  "flows_size": 50,
  "is_include_metadata": true,
  "is_enable_similarity_search": true
}
'

import requests

url = "https://api.pubrio.com/expansions/dashboard"

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,
    "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-06-01", "2026-06-29"],
    "window_days": 90,
    "min_markets": 3,
    "home_country_code": ["SG"],
    "industries": ["software", "financial services"],
    "exclude_industries": ["tobacco"],
    "select_size": 250,
    "flows_size": 50,
    "is_include_metadata": True,
    "is_enable_similarity_search": True
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    froms: ['US', 'GB'],
    tos: ['US', 'GB'],
    exclude_froms: ['US', 'GB'],
    exclude_tos: ['US', 'GB'],
    stages: ['committing', 'expanding'],
    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,
    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-06-01', '2026-06-29'],
    window_days: 90,
    min_markets: 3,
    home_country_code: ['SG'],
    industries: ['software', 'financial services'],
    exclude_industries: ['tobacco'],
    select_size: 250,
    flows_size: 50,
    is_include_metadata: true,
    is_enable_similarity_search: true
  })
};

fetch('https://api.pubrio.com/expansions/dashboard', 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/dashboard",
  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,
    '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-06-01',
        '2026-06-29'
    ],
    'window_days' => 90,
    'min_markets' => 3,
    'home_country_code' => [
        'SG'
    ],
    'industries' => [
        'software',
        'financial services'
    ],
    'exclude_industries' => [
        'tobacco'
    ],
    'select_size' => 250,
    'flows_size' => 50,
    'is_include_metadata' => true,
    'is_enable_similarity_search' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.pubrio.com/expansions/dashboard"

	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  \"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-06-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\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  \"select_size\": 250,\n  \"flows_size\": 50,\n  \"is_include_metadata\": true,\n  \"is_enable_similarity_search\": true\n}")

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

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

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pubrio.com/expansions/dashboard")
  .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  \"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-06-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\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  \"select_size\": 250,\n  \"flows_size\": 50,\n  \"is_include_metadata\": true,\n  \"is_enable_similarity_search\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/expansions/dashboard")

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  \"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-06-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\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  \"select_size\": 250,\n  \"flows_size\": 50,\n  \"is_include_metadata\": true,\n  \"is_enable_similarity_search\": true\n}"

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "filters": {
      "froms": [
        "CN"
      ],
      "tos": [
        "GB"
      ]
    },
    "select_size": 250,
    "flows_size": 50,
    "transitioned_dates": [
      "2026-06-01",
      "2026-06-29"
    ]
  },
  "data": {
    "countries": [
      {
        "country_code": "US",
        "inbound_count": 18,
        "outbound_count": 5,
        "total_companies_with_signals": 23,
        "exploring_count": 8,
        "committing_count": 10,
        "expanding_count": 4,
        "scaling_count": 1,
        "new_transitions_30d": 3,
        "pairs_ahead_of_pace_30d": 1,
        "freshest_transition_at": "2026-06-27T14:32:10.000Z"
      }
    ],
    "top_flows": [
      {
        "home_country_code": "SG",
        "country_code": "US",
        "company_count": 5,
        "new_transitions_30d": 1
      }
    ]
  }
}

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

dashboard

Vue d'ensemble Expansion

curl --request POST \
  --url https://api.pubrio.com/expansions/dashboard \
  --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,
  "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-06-01",
    "2026-06-29"
  ],
  "window_days": 90,
  "min_markets": 3,
  "home_country_code": [
    "SG"
  ],
  "industries": [
    "software",
    "financial services"
  ],
  "exclude_industries": [
    "tobacco"
  ],
  "select_size": 250,
  "flows_size": 50,
  "is_include_metadata": true,
  "is_enable_similarity_search": true
}
'

import requests

url = "https://api.pubrio.com/expansions/dashboard"

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,
    "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-06-01", "2026-06-29"],
    "window_days": 90,
    "min_markets": 3,
    "home_country_code": ["SG"],
    "industries": ["software", "financial services"],
    "exclude_industries": ["tobacco"],
    "select_size": 250,
    "flows_size": 50,
    "is_include_metadata": True,
    "is_enable_similarity_search": True
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    froms: ['US', 'GB'],
    tos: ['US', 'GB'],
    exclude_froms: ['US', 'GB'],
    exclude_tos: ['US', 'GB'],
    stages: ['committing', 'expanding'],
    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,
    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-06-01', '2026-06-29'],
    window_days: 90,
    min_markets: 3,
    home_country_code: ['SG'],
    industries: ['software', 'financial services'],
    exclude_industries: ['tobacco'],
    select_size: 250,
    flows_size: 50,
    is_include_metadata: true,
    is_enable_similarity_search: true
  })
};

fetch('https://api.pubrio.com/expansions/dashboard', 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/dashboard",
  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,
    '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-06-01',
        '2026-06-29'
    ],
    'window_days' => 90,
    'min_markets' => 3,
    'home_country_code' => [
        'SG'
    ],
    'industries' => [
        'software',
        'financial services'
    ],
    'exclude_industries' => [
        'tobacco'
    ],
    'select_size' => 250,
    'flows_size' => 50,
    'is_include_metadata' => true,
    'is_enable_similarity_search' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.pubrio.com/expansions/dashboard"

	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  \"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-06-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\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  \"select_size\": 250,\n  \"flows_size\": 50,\n  \"is_include_metadata\": true,\n  \"is_enable_similarity_search\": true\n}")

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

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

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pubrio.com/expansions/dashboard")
  .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  \"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-06-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\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  \"select_size\": 250,\n  \"flows_size\": 50,\n  \"is_include_metadata\": true,\n  \"is_enable_similarity_search\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/expansions/dashboard")

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  \"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-06-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\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  \"select_size\": 250,\n  \"flows_size\": 50,\n  \"is_include_metadata\": true,\n  \"is_enable_similarity_search\": true\n}"

response = http.request(request)
puts response.read_body

{
  "metadata": {
    "filters": {
      "froms": [
        "CN"
      ],
      "tos": [
        "GB"
      ]
    },
    "select_size": 250,
    "flows_size": 50,
    "transitioned_dates": [
      "2026-06-01",
      "2026-06-29"
    ]
  },
  "data": {
    "countries": [
      {
        "country_code": "US",
        "inbound_count": 18,
        "outbound_count": 5,
        "total_companies_with_signals": 23,
        "exploring_count": 8,
        "committing_count": 10,
        "expanding_count": 4,
        "scaling_count": 1,
        "new_transitions_30d": 3,
        "pairs_ahead_of_pace_30d": 1,
        "freshest_transition_at": "2026-06-27T14:32:10.000Z"
      }
    ],
    "top_flows": [
      {
        "home_country_code": "SG",
        "country_code": "US",
        "company_count": 5,
        "new_transitions_30d": 1
      }
    ]
  }
}

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

froms

string[]

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 entreprise/marché é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

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 [début, fin] pour la fenêtre d'affichage (carte, flux, et chronologie de la liste de surveillance). Par défaut sur les 90 derniers jours. L'indicateur new_transitions_30d utilise toujours sa propre fenêtre fixe de 30 jours, indépendamment de cette plage.

Exemple:

["2026-06-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

min_markets

integer

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

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

select_size

integer

Nombre maximum de marchés à renvoyer (plafonné selon le plan).

Exemple:

250

flows_size

integer

Nombre maximum de flux transfrontaliers à renvoyer (plafonné selon le plan).

Exemple:

50

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

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

Agrégats du tableau de bord de marché.

metadata

object

data

object

Conteneur du tableau de bord : marchés classés plus les principaux flux de corridor. Miroir hérité déprécié. Chaque conteneur à l'intérieur de data est aussi émis au niveau supérieur (countries, top_flows, picks_aggregate, watchlist_markets, watchlist_timeline) pour les anciens clients. Lisez-les depuis data — les copies de niveau supérieur seront supprimées.

Show child attributes

Documentation API

Point de terminaison

Autorisations

Corps

Réponse