Visão Geral de Expansão

Visão geral de expansão

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": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
  "details": {}
}

{
  "error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}

{
  "error": "Ocorreu um erro inesperado no servidor."
}

POST

expansions

dashboard

Visão geral de expansão

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": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
  "details": {}
}

{
  "error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}

{
  "error": "Ocorreu um erro inesperado no servidor."
}

Autorizações

pubrio-api-key

string

header

obrigatório

Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.

Corpo

application/json

froms

string[]

Mercados de origem (ISO 3166-1 alfa-2). De onde a empresa está se expandindo — seus países de origem/sede. Use sozinho para encontrar empresas crescendo a partir desses mercados; combine com tos para um corredor origem→destino específico.

Exemplo:

["US", "GB"]

tos

string[]

Mercados de destino (ISO 3166-1 alfa-2). Para onde a empresa está se expandindo. Use sozinho para encontrar todas as empresas entrando nesses mercados; combine com froms para um corredor origem→destino específico.

Exemplo:

["US", "GB"]

exclude_froms

string[]

Mercados de origem a excluir (ISO 3166-1 alfa-2).

Exemplo:

["US", "GB"]

exclude_tos

string[]

Mercados de destino a excluir (ISO 3166-1 alfa-2).

Exemplo:

["US", "GB"]

stages

enum<string>[]

Os valores diferenciam maiúsculas de minúsculas e não são validados. Um valor não reconhecido é descartado silenciosamente em vez de rejeitado: em stages, freshness, scopes e momentum, o filtro inteiro é descartado e você obtém resultados sem filtro, enquanto em signal_types e signal_strengths o filtro é aplicado e não corresponde a nada. De qualquer forma, a resposta parece normal. Resolva os slugs válidos em Expansion Reference e compare data.pagination.total_entries com uma chamada sem filtro caso um conjunto de resultados pareça incorreto.

Opções disponíveis:

exploring,

committing,

expanding,

scaling

Exemplo:

["committing", "expanding"]

momentum

enum<string>[]

Trajetória do movimento da empresa no mercado. advancing indica ganho de terreno, steady indica estabilidade, pulling_back cobre retração e contração.

Não use aqui os valores de directions em Expansion Reference. Esses (advancing, steady, retreating, new) são os valores de resposta retornados em stage.direction; apenas os três listados acima são aceitos como filtro. Enviar retreating ou new desativa o filtro silenciosamente e retorna resultados sem filtro.

Opções disponíveis:

advancing,

steady,

pulling_back

Exemplo:

["advancing", "steady"]

freshness

enum<string>[]

Opções disponíveis:

fresh,

cooling,

stale,

cold

Exemplo:

["fresh", "cooling"]

scopes

enum<string>[]

Filtra pelo escopo de entrada no mercado.

Opções disponíveis:

entering_new_market,

expanding_within_presence,

established_only

Exemplo:

["entering_new_market"]

ahead_of_pace

boolean

Restringe a pares empresa/mercado que avançam mais rápido que o ritmo típico daquele mercado.

Exemplo:

false

signal_types

enum<string>[]

Opções disponíveis:

AD,

AUDIENCE,

DNS,

ENTITY,

EVENT,

EVENT_PLUS,

EXEC,

HIRE,

INFRA,

IP,

NEWS,

OFFICE,

PARTNER,

PRODUCT,

REG,

SCALE,

TECH

Exemplo:

["EXEC", "HIRE"]

signal_strengths

enum<string>[]

Opções disponíveis:

low,

medium,

high,

very_high

Exemplo:

["high"]

min_signal_count

integer

Número mínimo de sinais de expansão que uma empresa deve ter na janela — "muito ativa / com forte presença".

Exemplo:

3

only_contraction

boolean

Quando verdadeiro, retorna apenas expansões marcadas como contração (empresas reduzindo suas operações).

Exemplo:

false

verticals

integer[]

Uma lista de vertical_id usada para buscar empresas em um vertical ou setor específico. Para encontrar o ID, chame o endpoint vertical na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["AI"].

vertical_categories

integer[]

Uma lista de vertical_category_id usada para buscar empresas em uma categoria vertical específica. Para encontrar o ID, chame o endpoint vertical category na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["Information Technology"].

vertical_sub_categories

integer[]

Uma lista de vertical_sub_category_id usada para buscar empresas em uma subcategoria vertical específica. Para encontrar o ID, chame o endpoint vertical sub category na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["Software"].

technologies

integer[]

Uma lista de tag_id usada para buscar tecnologias específicas utilizadas pelas empresas. Para encontrar o ID, chame o endpoint technology na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["Shopify"].

employees

string[][]

O intervalo numérico de funcionários que trabalham na empresa. Isso permite encontrar empresas com base no número de funcionários. Você pode adicionar múltiplos intervalos para expandir os resultados da busca.

Consulte os endpoints de company size na aba Filters para mais informações.

Exemplo:

[[1, 10], [11, 20], [10001]]

revenues

integer[]

Intervalo mínimo e máximo da receita da empresa.

Exemplo:

[0, 100000]

founded_dates

integer[]

Intervalo de anos de fundação da empresa. O valor máximo de fundação é o ano atual.

Exemplo:

[2018, 2024]

keywords

string[]

Uma lista de palavras-chave para filtrar empresas por relevância, especialidades ou descrições.

Exemplo:

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

companies

string[]

Restringe a empresas específicas usando qualquer combinação de domain_search_id, domínio da empresa ou URL de perfil de rede social da empresa. Domínios e URLs são resolvidos para a empresa de melhor classificação.

Exemplo:

[
  "stripe.com",
  "https://www.linkedin.com/company/airbnb",
  "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
]

job_locations

string[]

O padrão ISO 3166-1 alpha-2 (cca2) é usado para filtrar localizações. Consulte os endpoints location na aba Filters para mais informações.

Exemplo:

["US", "SG", "CN"]

job_exclude_locations

string[]

Localizações geográficas a serem excluídas dos resultados de vagas de emprego.

Exemplo:

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

job_posted_dates

string[]

Intervalo de datas de publicação. O valor máximo é o dia atual. Os limites do dia seguem o fuso horário do seu workspace.

Exemplo:

["2025-01-01", "2025-01-10"]

job_titles

string[]

Cargos associados aos indivíduos que você deseja localizar.

Os resultados também incluirão cargos que contenham terminologia semelhante, mesmo que não correspondam exatamente. Por exemplo, buscar por software engineer pode retornar resultados de indivíduos com o cargo senior software engineer.

Exemplo:

["sales manager", "marketing manager"]

advertisement_target_locations

string[]

Localizações geográficas alvo para anúncios.

Exemplo:

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

advertisement_exclude_target_locations

string[]

Localizações geográficas a serem excluídas da segmentação de anúncios.

Exemplo:

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

advertisement_search_terms

string[]

Palavras-chave usadas para buscar no conteúdo ou nos títulos dos anúncios.

Exemplo:

["asus"]

advertisement_start_dates

string<date>[]

Intervalo de data de início para filtragem de anúncios.

Exemplo:

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

advertisement_end_dates

string<date>[]

Intervalo de data de término para filtragem de anúncios.

Exemplo:

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

news_categories

string[]

Lista de category slugs para buscar categorias de notícias específicas. Para encontrar um slug, chame o endpoint news categories na aba Filters.

Exemplo:

["launches"]

news_published_dates

string[]

Intervalo de datas de publicação. O valor máximo é o dia atual. Os limites do dia seguem o fuso horário do seu workspace.

Exemplo:

["2025-01-01", "2025-01-10"]

transitioned_dates

string<date>[]

Intervalo de datas ISO [início, fim] para a janela de exibição (mapa, fluxos e linha do tempo da watchlist). O padrão são os últimos 90 dias. O KPI new_transitions_30d sempre usa sua própria janela fixa de 30 dias, independentemente deste intervalo.

Exemplo:

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

window_days

integer

Opcional. Tamanho da janela móvel em dias. Usado quando um intervalo explícito de transitioned_dates não é fornecido; se ambos forem omitidos, uma janela padrão é usada.

Exemplo:

90

min_markets

integer

Número mínimo de novos mercados que uma empresa deve ter entrado na janela (expansão ampla).

Exemplo:

3

home_country_code

string[]

Filtra pelo país de origem da empresa (ISO 3166-1 alpha-2). Faz interseção com froms quando ambos são informados.

Exemplo:

["SG"]

industries

string[]

Filtra pelo nome do setor (correspondência por texto livre).

Exemplo:

["software", "financial services"]

exclude_industries

string[]

Setores a excluir (correspondência por texto livre).

Exemplo:

["tobacco"]

select_size

integer

Número máximo de mercados a retornar (limitado pelo plano).

Exemplo:

250

flows_size

integer

Número máximo de fluxos transfronteiriços a retornar (limitado pelo plano).

Exemplo:

50

is_include_metadata

boolean

Retorna o payload completo de detalhes. O tráfego via chave de API é enxuto por padrão: o bloco model, os valores de confiança (stage.confidence em Company Expansion Detail, confidence_score em other_markets[] e em markers[] de Rankings) e os campos established_min / share_of_detected / has_known_office são todos omitidos, a menos que este valor seja true.

Exemplo:

true

is_enable_similarity_search

boolean

Ativa a correspondência por texto livre para verticals, vertical_categories, vertical_sub_categories e technologies; esses filtros são descartados a menos que este valor seja true.

Exemplo:

true

Resposta

Agregados do painel de mercado.

metadata

object

data

object

Contêiner do painel: mercados classificados mais os principais fluxos entre corredores. Espelho legado obsoleto. Todo contêiner dentro de data também é emitido no nível superior (countries, top_flows, picks_aggregate, watchlist_markets, watchlist_timeline) para clientes mais antigos. Leia-os a partir de data — as cópias no nível superior serão removidas.

Show child attributes

Documentação da API

Endpoints

Autorizações

Corpo

Resposta