Busca de Expansão

Busca de expansão

curl --request POST \
  --url https://api.pubrio.com/expansions/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "froms": [
    "US",
    "GB"
  ],
  "tos": [
    "US",
    "GB"
  ],
  "exclude_froms": [
    "US",
    "GB"
  ],
  "exclude_tos": [
    "US",
    "GB"
  ],
  "stages": [
    "committing",
    "expanding"
  ],
  "momentum": [
    "advancing",
    "steady"
  ],
  "freshness": [
    "fresh",
    "cooling"
  ],
  "scopes": [
    "entering_new_market"
  ],
  "ahead_of_pace": false,
  "signal_types": [
    "EXEC",
    "HIRE"
  ],
  "signal_strengths": [
    "high"
  ],
  "min_signal_count": 3,
  "only_contraction": false,
  "min_markets": 3,
  "home_country_code": [
    "SG"
  ],
  "industries": [
    "software",
    "financial services"
  ],
  "exclude_industries": [
    "tobacco"
  ],
  "verticals": [
    123
  ],
  "vertical_categories": [
    123
  ],
  "vertical_sub_categories": [
    123
  ],
  "technologies": [
    123
  ],
  "employees": [
    [
      1,
      10
    ],
    [
      11,
      20
    ],
    [
      10001
    ]
  ],
  "revenues": [
    0,
    100000
  ],
  "founded_dates": [
    2018,
    2024
  ],
  "keywords": [
    "ecommerce",
    "ai",
    "fintech"
  ],
  "companies": [
    "stripe.com",
    "https://www.linkedin.com/company/airbnb",
    "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
  ],
  "job_locations": [
    "US",
    "SG",
    "CN"
  ],
  "job_exclude_locations": [
    "CN",
    "US",
    "RU",
    "CA"
  ],
  "job_posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "job_titles": [
    "sales manager",
    "marketing manager"
  ],
  "advertisement_target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "advertisement_exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "advertisement_search_terms": [
    "asus"
  ],
  "advertisement_start_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "advertisement_end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "news_categories": [
    "launches"
  ],
  "news_published_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "transitioned_dates": [
    "2026-04-01",
    "2026-06-29"
  ],
  "window_days": 90,
  "query": "fintech companies expanding into the UK",
  "is_explain_match": true,
  "sort_by": "expansion_score",
  "is_include_metadata": true,
  "page": 1,
  "per_page": 25,
  "is_enable_similarity_search": true
}
'

import requests

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

payload = {
    "froms": ["US", "GB"],
    "tos": ["US", "GB"],
    "exclude_froms": ["US", "GB"],
    "exclude_tos": ["US", "GB"],
    "stages": ["committing", "expanding"],
    "momentum": ["advancing", "steady"],
    "freshness": ["fresh", "cooling"],
    "scopes": ["entering_new_market"],
    "ahead_of_pace": False,
    "signal_types": ["EXEC", "HIRE"],
    "signal_strengths": ["high"],
    "min_signal_count": 3,
    "only_contraction": False,
    "min_markets": 3,
    "home_country_code": ["SG"],
    "industries": ["software", "financial services"],
    "exclude_industries": ["tobacco"],
    "verticals": [123],
    "vertical_categories": [123],
    "vertical_sub_categories": [123],
    "technologies": [123],
    "employees": [[1, 10], [11, 20], [10001]],
    "revenues": [0, 100000],
    "founded_dates": [2018, 2024],
    "keywords": ["ecommerce", "ai", "fintech"],
    "companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],
    "job_locations": ["US", "SG", "CN"],
    "job_exclude_locations": ["CN", "US", "RU", "CA"],
    "job_posted_dates": ["2025-01-01", "2025-01-10"],
    "job_titles": ["sales manager", "marketing manager"],
    "advertisement_target_locations": ["TW", "AE", "NO"],
    "advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
    "advertisement_search_terms": ["asus"],
    "advertisement_start_dates": ["2025-12-25", "2025-12-25"],
    "advertisement_end_dates": ["2025-12-25", "2025-12-25"],
    "news_categories": ["launches"],
    "news_published_dates": ["2025-01-01", "2025-01-10"],
    "transitioned_dates": ["2026-04-01", "2026-06-29"],
    "window_days": 90,
    "query": "fintech companies expanding into the UK",
    "is_explain_match": True,
    "sort_by": "expansion_score",
    "is_include_metadata": True,
    "page": 1,
    "per_page": 25,
    "is_enable_similarity_search": True
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    froms: ['US', 'GB'],
    tos: ['US', 'GB'],
    exclude_froms: ['US', 'GB'],
    exclude_tos: ['US', 'GB'],
    stages: ['committing', 'expanding'],
    momentum: ['advancing', 'steady'],
    freshness: ['fresh', 'cooling'],
    scopes: ['entering_new_market'],
    ahead_of_pace: false,
    signal_types: ['EXEC', 'HIRE'],
    signal_strengths: ['high'],
    min_signal_count: 3,
    only_contraction: false,
    min_markets: 3,
    home_country_code: ['SG'],
    industries: ['software', 'financial services'],
    exclude_industries: ['tobacco'],
    verticals: [123],
    vertical_categories: [123],
    vertical_sub_categories: [123],
    technologies: [123],
    employees: [[1, 10], [11, 20], [10001]],
    revenues: [0, 100000],
    founded_dates: [2018, 2024],
    keywords: ['ecommerce', 'ai', 'fintech'],
    companies: [
      'stripe.com',
      'https://www.linkedin.com/company/airbnb',
      'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
    ],
    job_locations: ['US', 'SG', 'CN'],
    job_exclude_locations: ['CN', 'US', 'RU', 'CA'],
    job_posted_dates: ['2025-01-01', '2025-01-10'],
    job_titles: ['sales manager', 'marketing manager'],
    advertisement_target_locations: ['TW', 'AE', 'NO'],
    advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
    advertisement_search_terms: ['asus'],
    advertisement_start_dates: ['2025-12-25', '2025-12-25'],
    advertisement_end_dates: ['2025-12-25', '2025-12-25'],
    news_categories: ['launches'],
    news_published_dates: ['2025-01-01', '2025-01-10'],
    transitioned_dates: ['2026-04-01', '2026-06-29'],
    window_days: 90,
    query: 'fintech companies expanding into the UK',
    is_explain_match: true,
    sort_by: 'expansion_score',
    is_include_metadata: true,
    page: 1,
    per_page: 25,
    is_enable_similarity_search: true
  })
};

fetch('https://api.pubrio.com/expansions/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/expansions/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'froms' => [
        'US',
        'GB'
    ],
    'tos' => [
        'US',
        'GB'
    ],
    'exclude_froms' => [
        'US',
        'GB'
    ],
    'exclude_tos' => [
        'US',
        'GB'
    ],
    'stages' => [
        'committing',
        'expanding'
    ],
    'momentum' => [
        'advancing',
        'steady'
    ],
    'freshness' => [
        'fresh',
        'cooling'
    ],
    'scopes' => [
        'entering_new_market'
    ],
    'ahead_of_pace' => false,
    'signal_types' => [
        'EXEC',
        'HIRE'
    ],
    'signal_strengths' => [
        'high'
    ],
    'min_signal_count' => 3,
    'only_contraction' => false,
    'min_markets' => 3,
    'home_country_code' => [
        'SG'
    ],
    'industries' => [
        'software',
        'financial services'
    ],
    'exclude_industries' => [
        'tobacco'
    ],
    'verticals' => [
        123
    ],
    'vertical_categories' => [
        123
    ],
    'vertical_sub_categories' => [
        123
    ],
    'technologies' => [
        123
    ],
    'employees' => [
        [
                1,
                10
        ],
        [
                11,
                20
        ],
        [
                10001
        ]
    ],
    'revenues' => [
        0,
        100000
    ],
    'founded_dates' => [
        2018,
        2024
    ],
    'keywords' => [
        'ecommerce',
        'ai',
        'fintech'
    ],
    'companies' => [
        'stripe.com',
        'https://www.linkedin.com/company/airbnb',
        'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
    ],
    'job_locations' => [
        'US',
        'SG',
        'CN'
    ],
    'job_exclude_locations' => [
        'CN',
        'US',
        'RU',
        'CA'
    ],
    'job_posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'job_titles' => [
        'sales manager',
        'marketing manager'
    ],
    'advertisement_target_locations' => [
        'TW',
        'AE',
        'NO'
    ],
    'advertisement_exclude_target_locations' => [
        'IS',
        'GB',
        'FR',
        'IE',
        'ES'
    ],
    'advertisement_search_terms' => [
        'asus'
    ],
    'advertisement_start_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'advertisement_end_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'news_categories' => [
        'launches'
    ],
    'news_published_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'transitioned_dates' => [
        '2026-04-01',
        '2026-06-29'
    ],
    'window_days' => 90,
    'query' => 'fintech companies expanding into the UK',
    'is_explain_match' => true,
    'sort_by' => 'expansion_score',
    'is_include_metadata' => true,
    'page' => 1,
    'per_page' => 25,
    'is_enable_similarity_search' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"momentum\": [\n    \"advancing\",\n    \"steady\"\n  ],\n  \"freshness\": [\n    \"fresh\",\n    \"cooling\"\n  ],\n  \"scopes\": [\n    \"entering_new_market\"\n  ],\n  \"ahead_of_pace\": false,\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\n  \"home_country_code\": [\n    \"SG\"\n  ],\n  \"industries\": [\n    \"software\",\n    \"financial services\"\n  ],\n  \"exclude_industries\": [\n    \"tobacco\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"query\": \"fintech companies expanding into the UK\",\n  \"is_explain_match\": true,\n  \"sort_by\": \"expansion_score\",\n  \"is_include_metadata\": true,\n  \"page\": 1,\n  \"per_page\": 25,\n  \"is_enable_similarity_search\": true\n}")

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

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

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pubrio.com/expansions/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"momentum\": [\n    \"advancing\",\n    \"steady\"\n  ],\n  \"freshness\": [\n    \"fresh\",\n    \"cooling\"\n  ],\n  \"scopes\": [\n    \"entering_new_market\"\n  ],\n  \"ahead_of_pace\": false,\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\n  \"home_country_code\": [\n    \"SG\"\n  ],\n  \"industries\": [\n    \"software\",\n    \"financial services\"\n  ],\n  \"exclude_industries\": [\n    \"tobacco\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"query\": \"fintech companies expanding into the UK\",\n  \"is_explain_match\": true,\n  \"sort_by\": \"expansion_score\",\n  \"is_include_metadata\": true,\n  \"page\": 1,\n  \"per_page\": 25,\n  \"is_enable_similarity_search\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"momentum\": [\n    \"advancing\",\n    \"steady\"\n  ],\n  \"freshness\": [\n    \"fresh\",\n    \"cooling\"\n  ],\n  \"scopes\": [\n    \"entering_new_market\"\n  ],\n  \"ahead_of_pace\": false,\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\n  \"home_country_code\": [\n    \"SG\"\n  ],\n  \"industries\": [\n    \"software\",\n    \"financial services\"\n  ],\n  \"exclude_industries\": [\n    \"tobacco\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"query\": \"fintech companies expanding into the UK\",\n  \"is_explain_match\": true,\n  \"sort_by\": \"expansion_score\",\n  \"is_include_metadata\": true,\n  \"page\": 1,\n  \"per_page\": 25,\n  \"is_enable_similarity_search\": true\n}"

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

{
  "metadata": {
    "filters": {
      "tos": [
        "GB"
      ],
      "verticals": [
        "Financial Services"
      ]
    }
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 87,
      "total_pages": 4,
      "total_display_pages": 4,
      "is_timeout": false
    },
    "companies": [
      {
        "expansion_id": "6845525",
        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
        "country_code": "GB",
        "target_country_code": "GB",
        "domain": "example.com",
        "company_name": "Example Corp",
        "home_country_code": "CN",
        "industry": "Consumer Electronics",
        "founded_year": 2015,
        "employees_count": 320,
        "stage": {
          "slug": "expanding",
          "expansion_score": 0.72,
          "scope": "entering_new_market",
          "direction": "advancing",
          "freshness": "fresh",
          "signal_count": 27,
          "distinct_type_count": 3,
          "last_transition_at": "2026-06-27T14:32:10.000Z"
        },
        "presence": {
          "level": "established",
          "local_people_count": 12,
          "matched_rule": "headcount",
          "has_known_office": true,
          "established_min": 10,
          "share_of_detected": 0.54
        },
        "read": {
          "code": "establishing"
        }
      }
    ]
  }
}

{
  "code": 40001,
  "message": "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

Busca de expansão

curl --request POST \
  --url https://api.pubrio.com/expansions/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "froms": [
    "US",
    "GB"
  ],
  "tos": [
    "US",
    "GB"
  ],
  "exclude_froms": [
    "US",
    "GB"
  ],
  "exclude_tos": [
    "US",
    "GB"
  ],
  "stages": [
    "committing",
    "expanding"
  ],
  "momentum": [
    "advancing",
    "steady"
  ],
  "freshness": [
    "fresh",
    "cooling"
  ],
  "scopes": [
    "entering_new_market"
  ],
  "ahead_of_pace": false,
  "signal_types": [
    "EXEC",
    "HIRE"
  ],
  "signal_strengths": [
    "high"
  ],
  "min_signal_count": 3,
  "only_contraction": false,
  "min_markets": 3,
  "home_country_code": [
    "SG"
  ],
  "industries": [
    "software",
    "financial services"
  ],
  "exclude_industries": [
    "tobacco"
  ],
  "verticals": [
    123
  ],
  "vertical_categories": [
    123
  ],
  "vertical_sub_categories": [
    123
  ],
  "technologies": [
    123
  ],
  "employees": [
    [
      1,
      10
    ],
    [
      11,
      20
    ],
    [
      10001
    ]
  ],
  "revenues": [
    0,
    100000
  ],
  "founded_dates": [
    2018,
    2024
  ],
  "keywords": [
    "ecommerce",
    "ai",
    "fintech"
  ],
  "companies": [
    "stripe.com",
    "https://www.linkedin.com/company/airbnb",
    "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
  ],
  "job_locations": [
    "US",
    "SG",
    "CN"
  ],
  "job_exclude_locations": [
    "CN",
    "US",
    "RU",
    "CA"
  ],
  "job_posted_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "job_titles": [
    "sales manager",
    "marketing manager"
  ],
  "advertisement_target_locations": [
    "TW",
    "AE",
    "NO"
  ],
  "advertisement_exclude_target_locations": [
    "IS",
    "GB",
    "FR",
    "IE",
    "ES"
  ],
  "advertisement_search_terms": [
    "asus"
  ],
  "advertisement_start_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "advertisement_end_dates": [
    "2025-12-25",
    "2025-12-25"
  ],
  "news_categories": [
    "launches"
  ],
  "news_published_dates": [
    "2025-01-01",
    "2025-01-10"
  ],
  "transitioned_dates": [
    "2026-04-01",
    "2026-06-29"
  ],
  "window_days": 90,
  "query": "fintech companies expanding into the UK",
  "is_explain_match": true,
  "sort_by": "expansion_score",
  "is_include_metadata": true,
  "page": 1,
  "per_page": 25,
  "is_enable_similarity_search": true
}
'

import requests

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

payload = {
    "froms": ["US", "GB"],
    "tos": ["US", "GB"],
    "exclude_froms": ["US", "GB"],
    "exclude_tos": ["US", "GB"],
    "stages": ["committing", "expanding"],
    "momentum": ["advancing", "steady"],
    "freshness": ["fresh", "cooling"],
    "scopes": ["entering_new_market"],
    "ahead_of_pace": False,
    "signal_types": ["EXEC", "HIRE"],
    "signal_strengths": ["high"],
    "min_signal_count": 3,
    "only_contraction": False,
    "min_markets": 3,
    "home_country_code": ["SG"],
    "industries": ["software", "financial services"],
    "exclude_industries": ["tobacco"],
    "verticals": [123],
    "vertical_categories": [123],
    "vertical_sub_categories": [123],
    "technologies": [123],
    "employees": [[1, 10], [11, 20], [10001]],
    "revenues": [0, 100000],
    "founded_dates": [2018, 2024],
    "keywords": ["ecommerce", "ai", "fintech"],
    "companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],
    "job_locations": ["US", "SG", "CN"],
    "job_exclude_locations": ["CN", "US", "RU", "CA"],
    "job_posted_dates": ["2025-01-01", "2025-01-10"],
    "job_titles": ["sales manager", "marketing manager"],
    "advertisement_target_locations": ["TW", "AE", "NO"],
    "advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
    "advertisement_search_terms": ["asus"],
    "advertisement_start_dates": ["2025-12-25", "2025-12-25"],
    "advertisement_end_dates": ["2025-12-25", "2025-12-25"],
    "news_categories": ["launches"],
    "news_published_dates": ["2025-01-01", "2025-01-10"],
    "transitioned_dates": ["2026-04-01", "2026-06-29"],
    "window_days": 90,
    "query": "fintech companies expanding into the UK",
    "is_explain_match": True,
    "sort_by": "expansion_score",
    "is_include_metadata": True,
    "page": 1,
    "per_page": 25,
    "is_enable_similarity_search": True
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    froms: ['US', 'GB'],
    tos: ['US', 'GB'],
    exclude_froms: ['US', 'GB'],
    exclude_tos: ['US', 'GB'],
    stages: ['committing', 'expanding'],
    momentum: ['advancing', 'steady'],
    freshness: ['fresh', 'cooling'],
    scopes: ['entering_new_market'],
    ahead_of_pace: false,
    signal_types: ['EXEC', 'HIRE'],
    signal_strengths: ['high'],
    min_signal_count: 3,
    only_contraction: false,
    min_markets: 3,
    home_country_code: ['SG'],
    industries: ['software', 'financial services'],
    exclude_industries: ['tobacco'],
    verticals: [123],
    vertical_categories: [123],
    vertical_sub_categories: [123],
    technologies: [123],
    employees: [[1, 10], [11, 20], [10001]],
    revenues: [0, 100000],
    founded_dates: [2018, 2024],
    keywords: ['ecommerce', 'ai', 'fintech'],
    companies: [
      'stripe.com',
      'https://www.linkedin.com/company/airbnb',
      'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
    ],
    job_locations: ['US', 'SG', 'CN'],
    job_exclude_locations: ['CN', 'US', 'RU', 'CA'],
    job_posted_dates: ['2025-01-01', '2025-01-10'],
    job_titles: ['sales manager', 'marketing manager'],
    advertisement_target_locations: ['TW', 'AE', 'NO'],
    advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
    advertisement_search_terms: ['asus'],
    advertisement_start_dates: ['2025-12-25', '2025-12-25'],
    advertisement_end_dates: ['2025-12-25', '2025-12-25'],
    news_categories: ['launches'],
    news_published_dates: ['2025-01-01', '2025-01-10'],
    transitioned_dates: ['2026-04-01', '2026-06-29'],
    window_days: 90,
    query: 'fintech companies expanding into the UK',
    is_explain_match: true,
    sort_by: 'expansion_score',
    is_include_metadata: true,
    page: 1,
    per_page: 25,
    is_enable_similarity_search: true
  })
};

fetch('https://api.pubrio.com/expansions/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pubrio.com/expansions/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'froms' => [
        'US',
        'GB'
    ],
    'tos' => [
        'US',
        'GB'
    ],
    'exclude_froms' => [
        'US',
        'GB'
    ],
    'exclude_tos' => [
        'US',
        'GB'
    ],
    'stages' => [
        'committing',
        'expanding'
    ],
    'momentum' => [
        'advancing',
        'steady'
    ],
    'freshness' => [
        'fresh',
        'cooling'
    ],
    'scopes' => [
        'entering_new_market'
    ],
    'ahead_of_pace' => false,
    'signal_types' => [
        'EXEC',
        'HIRE'
    ],
    'signal_strengths' => [
        'high'
    ],
    'min_signal_count' => 3,
    'only_contraction' => false,
    'min_markets' => 3,
    'home_country_code' => [
        'SG'
    ],
    'industries' => [
        'software',
        'financial services'
    ],
    'exclude_industries' => [
        'tobacco'
    ],
    'verticals' => [
        123
    ],
    'vertical_categories' => [
        123
    ],
    'vertical_sub_categories' => [
        123
    ],
    'technologies' => [
        123
    ],
    'employees' => [
        [
                1,
                10
        ],
        [
                11,
                20
        ],
        [
                10001
        ]
    ],
    'revenues' => [
        0,
        100000
    ],
    'founded_dates' => [
        2018,
        2024
    ],
    'keywords' => [
        'ecommerce',
        'ai',
        'fintech'
    ],
    'companies' => [
        'stripe.com',
        'https://www.linkedin.com/company/airbnb',
        'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
    ],
    'job_locations' => [
        'US',
        'SG',
        'CN'
    ],
    'job_exclude_locations' => [
        'CN',
        'US',
        'RU',
        'CA'
    ],
    'job_posted_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'job_titles' => [
        'sales manager',
        'marketing manager'
    ],
    'advertisement_target_locations' => [
        'TW',
        'AE',
        'NO'
    ],
    'advertisement_exclude_target_locations' => [
        'IS',
        'GB',
        'FR',
        'IE',
        'ES'
    ],
    'advertisement_search_terms' => [
        'asus'
    ],
    'advertisement_start_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'advertisement_end_dates' => [
        '2025-12-25',
        '2025-12-25'
    ],
    'news_categories' => [
        'launches'
    ],
    'news_published_dates' => [
        '2025-01-01',
        '2025-01-10'
    ],
    'transitioned_dates' => [
        '2026-04-01',
        '2026-06-29'
    ],
    'window_days' => 90,
    'query' => 'fintech companies expanding into the UK',
    'is_explain_match' => true,
    'sort_by' => 'expansion_score',
    'is_include_metadata' => true,
    'page' => 1,
    'per_page' => 25,
    'is_enable_similarity_search' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"momentum\": [\n    \"advancing\",\n    \"steady\"\n  ],\n  \"freshness\": [\n    \"fresh\",\n    \"cooling\"\n  ],\n  \"scopes\": [\n    \"entering_new_market\"\n  ],\n  \"ahead_of_pace\": false,\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\n  \"home_country_code\": [\n    \"SG\"\n  ],\n  \"industries\": [\n    \"software\",\n    \"financial services\"\n  ],\n  \"exclude_industries\": [\n    \"tobacco\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"query\": \"fintech companies expanding into the UK\",\n  \"is_explain_match\": true,\n  \"sort_by\": \"expansion_score\",\n  \"is_include_metadata\": true,\n  \"page\": 1,\n  \"per_page\": 25,\n  \"is_enable_similarity_search\": true\n}")

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

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

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.pubrio.com/expansions/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"momentum\": [\n    \"advancing\",\n    \"steady\"\n  ],\n  \"freshness\": [\n    \"fresh\",\n    \"cooling\"\n  ],\n  \"scopes\": [\n    \"entering_new_market\"\n  ],\n  \"ahead_of_pace\": false,\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\n  \"home_country_code\": [\n    \"SG\"\n  ],\n  \"industries\": [\n    \"software\",\n    \"financial services\"\n  ],\n  \"exclude_industries\": [\n    \"tobacco\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"query\": \"fintech companies expanding into the UK\",\n  \"is_explain_match\": true,\n  \"sort_by\": \"expansion_score\",\n  \"is_include_metadata\": true,\n  \"page\": 1,\n  \"per_page\": 25,\n  \"is_enable_similarity_search\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_froms\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"exclude_tos\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"stages\": [\n    \"committing\",\n    \"expanding\"\n  ],\n  \"momentum\": [\n    \"advancing\",\n    \"steady\"\n  ],\n  \"freshness\": [\n    \"fresh\",\n    \"cooling\"\n  ],\n  \"scopes\": [\n    \"entering_new_market\"\n  ],\n  \"ahead_of_pace\": false,\n  \"signal_types\": [\n    \"EXEC\",\n    \"HIRE\"\n  ],\n  \"signal_strengths\": [\n    \"high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\n  \"home_country_code\": [\n    \"SG\"\n  ],\n  \"industries\": [\n    \"software\",\n    \"financial services\"\n  ],\n  \"exclude_industries\": [\n    \"tobacco\"\n  ],\n  \"verticals\": [\n    123\n  ],\n  \"vertical_categories\": [\n    123\n  ],\n  \"vertical_sub_categories\": [\n    123\n  ],\n  \"technologies\": [\n    123\n  ],\n  \"employees\": [\n    [\n      1,\n      10\n    ],\n    [\n      11,\n      20\n    ],\n    [\n      10001\n    ]\n  ],\n  \"revenues\": [\n    0,\n    100000\n  ],\n  \"founded_dates\": [\n    2018,\n    2024\n  ],\n  \"keywords\": [\n    \"ecommerce\",\n    \"ai\",\n    \"fintech\"\n  ],\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n  ],\n  \"job_locations\": [\n    \"US\",\n    \"SG\",\n    \"CN\"\n  ],\n  \"job_exclude_locations\": [\n    \"CN\",\n    \"US\",\n    \"RU\",\n    \"CA\"\n  ],\n  \"job_posted_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"job_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"advertisement_target_locations\": [\n    \"TW\",\n    \"AE\",\n    \"NO\"\n  ],\n  \"advertisement_exclude_target_locations\": [\n    \"IS\",\n    \"GB\",\n    \"FR\",\n    \"IE\",\n    \"ES\"\n  ],\n  \"advertisement_search_terms\": [\n    \"asus\"\n  ],\n  \"advertisement_start_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"advertisement_end_dates\": [\n    \"2025-12-25\",\n    \"2025-12-25\"\n  ],\n  \"news_categories\": [\n    \"launches\"\n  ],\n  \"news_published_dates\": [\n    \"2025-01-01\",\n    \"2025-01-10\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"query\": \"fintech companies expanding into the UK\",\n  \"is_explain_match\": true,\n  \"sort_by\": \"expansion_score\",\n  \"is_include_metadata\": true,\n  \"page\": 1,\n  \"per_page\": 25,\n  \"is_enable_similarity_search\": true\n}"

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

{
  "metadata": {
    "filters": {
      "tos": [
        "GB"
      ],
      "verticals": [
        "Financial Services"
      ]
    }
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 87,
      "total_pages": 4,
      "total_display_pages": 4,
      "is_timeout": false
    },
    "companies": [
      {
        "expansion_id": "6845525",
        "domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
        "country_code": "GB",
        "target_country_code": "GB",
        "domain": "example.com",
        "company_name": "Example Corp",
        "home_country_code": "CN",
        "industry": "Consumer Electronics",
        "founded_year": 2015,
        "employees_count": 320,
        "stage": {
          "slug": "expanding",
          "expansion_score": 0.72,
          "scope": "entering_new_market",
          "direction": "advancing",
          "freshness": "fresh",
          "signal_count": 27,
          "distinct_type_count": 3,
          "last_transition_at": "2026-06-27T14:32:10.000Z"
        },
        "presence": {
          "level": "established",
          "local_people_count": 12,
          "matched_rule": "headcount",
          "has_known_office": true,
          "established_min": 10,
          "share_of_detected": 0.54
        },
        "read": {
          "code": "establishing"
        }
      }
    ]
  }
}

{
  "code": 40001,
  "message": "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

From Markets
To Markets
Plain-language Query
Companies

froms

string[]

obrigatório

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

min_markets

integer

Número mínimo de novos mercados que uma empresa deve ter entrado na janela.

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

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 para a janela da linha do tempo. O padrão são os últimos 90 dias. Uma query em linguagem natural também pode definir esse intervalo a partir de expressões de calendário ("this year", "last year", "Q2 2026").

Exemplo:

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

query

string

Consulta em linguagem natural que a Pubrio interpreta em filtros de expansão + empresa.

Exemplo:

"fintech companies expanding into the UK"

is_explain_match

boolean

Inclui explicações geradas por IA sobre por que cada empresa corresponde à busca, fundamentadas nos sinais reais da empresa. Funciona melhor combinado a uma consulta em linguagem natural. O número de sinais citados e o tamanho do lote escalam com per_page; fontes de alto volume (vagas publicadas, campanhas publicitárias) são resumidas como uma contagem por janela (ex.: "12 job postings") em vez de listadas individualmente.

Exemplo:

true

sort_by

enum<string>

Ordenação dos resultados. Omita para a ordem de relevância padrão: pares corroborados primeiro (2 ou mais tipos de sinal distintos), depois pares com evidência repetida (3 ou mais sinais), depois o restante — os transicionados mais recentemente primeiro dentro de cada nível. recent — pura recência (transicionados mais recentemente primeiro). expansion_score — maior pontuação de expansão primeiro. signal_count — pares com mais sinais primeiro. company_ranking — classificação geral da empresa segundo a Pubrio (quanto menor, mais em destaque), em ordem crescente.

Opções disponíveis:

recent,

expansion_score,

signal_count,

company_ranking

Exemplo:

"expansion_score"

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

page

integer

padrão:1

Número da página, começando em 1. O teto é o max_search_page da sua assinatura (max_company_search_page para busca de empresas), retornado por Profile. Excedê-lo retorna HTTP 416.

Exemplo:

1

per_page

integer

padrão:25

Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o max_search_per_page da sua assinatura, retornado por Profile. Excedê-lo retorna HTTP 416 com o código 41676 (ou 41613 na busca de empresas e pessoas), não um conjunto de resultados limitado.

Intervalo necessário: x <= 25

Exemplo:

25

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

Lista paginada de empresas em expansão no(s) mercado(s). filters reflete os critérios aplicados (ou interpretados a partir da linguagem natural); cada empresa inclui um match_summary quando is_explain_match é true.

metadata

object

Metadados da busca: os filtros efetivamente aplicados, mais a consolidação de mercado (agregado, escopo geográfico, principais origens/destinos/setores, linha do tempo). As respostas via chave de API incluem a consolidação apenas quando is_include_metadata é true.

Show child attributes

data

object

Contêiner de resultado (envelope padrão de busca): a lista de empresas mais a paginação.

Show child attributes

Última modificação em 4 de setembro de 2026

Documentação da API

Endpoints

Autorizações

Corpo

Resposta