Поиск по экспансии

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

import requests

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

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

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

print(response.text)

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

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

<?php

$curl = curl_init();

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

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

curl_close($curl);

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

package main

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

func main() {

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

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

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

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

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

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

	fmt.Println(string(body))

}

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

require 'uri'
require 'net/http'

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

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

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

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

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

{
  "code": 40001,
  "message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

Экспансия

Поиск экспансии

Поиск компаний, выходящих на один или несколько рынков, с использованием фирмографических фильтров и фильтров сигналов или запроса на естественном языке, с возможными пояснениями совпадений от ИИ, основанными на реальных сигналах каждой компании.

POST

expansions

Поиск по экспансии

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

import requests

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

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

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

print(response.text)

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

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

<?php

$curl = curl_init();

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

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

curl_close($curl);

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

package main

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

func main() {

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

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

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

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

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

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

	fmt.Println(string(body))

}

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

require 'uri'
require 'net/http'

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

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

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

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

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

{
  "code": 40001,
  "message": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

Авторизации

pubrio-api-key

string

header

обязательно

Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе Settings.

Тело

application/json

From Markets
To Markets
Plain-language Query
Companies

froms

string[]

обязательно

Рынки происхождения (ISO 3166-1 alpha-2). ОТКУДА расширяется компания — её домашние страны / страны штаб-квартиры. Используйте отдельно, чтобы найти компании, растущие из этих рынков; сочетайте с tos для конкретного коридора откуда→куда.

Пример:

["US", "GB"]

tos

string[]

Целевые рынки (ISO 3166-1 alpha-2). КУДА расширяется компания. Используйте отдельно, чтобы найти все компании, выходящие на эти рынки; сочетайте с froms для конкретного коридора откуда→куда.

Пример:

["US", "GB"]

exclude_froms

string[]

Рынки происхождения для исключения (ISO 3166-1 alpha-2).

Пример:

["US", "GB"]

exclude_tos

string[]

Целевые рынки для исключения (ISO 3166-1 alpha-2).

Пример:

["US", "GB"]

stages

enum<string>[]

Значения чувствительны к регистру и не проверяются. Нераспознанное значение молча отбрасывается, а не отклоняется: для stages, freshness, scopes и momentum весь фильтр отбрасывается, и вы получаете неотфильтрованные результаты, а для signal_types и signal_strengths фильтр применяется и не находит ничего. В любом случае ответ выглядит обычным. Получите допустимые слаги из Expansion Reference и сравните data.pagination.total_entries с вызовом без фильтров, если набор результатов выглядит некорректно.

Доступные опции:

exploring,

committing,

expanding,

scaling

Пример:

["committing", "expanding"]

momentum

enum<string>[]

Траектория движения компании на рынке. advancing — набирает позиции, steady — удерживает позиции, pulling_back охватывает отступление и сокращение.

Не используйте здесь значения из directions в Expansion Reference. Те значения (advancing, steady, retreating, new) — это значения ответа, которые возвращаются в stage.direction; в качестве фильтра принимаются только три значения, перечисленные выше. Передача retreating или new молча отключает фильтр и возвращает неотфильтрованные результаты.

Доступные опции:

advancing,

steady,

pulling_back

Пример:

["advancing", "steady"]

freshness

enum<string>[]

Доступные опции:

fresh,

cooling,

stale,

cold

Пример:

["fresh", "cooling"]

scopes

enum<string>[]

Фильтр по охвату выхода на рынок.

Доступные опции:

entering_new_market,

expanding_within_presence,

established_only

Пример:

["entering_new_market"]

ahead_of_pace

boolean

Ограничить парами, движущимися быстрее типичного темпа для этого рынка.

Пример:

false

signal_types

enum<string>[]

Доступные опции:

AD,

AUDIENCE,

DNS,

ENTITY,

EVENT,

EVENT_PLUS,

EXEC,

HIRE,

INFRA,

IP,

NEWS,

OFFICE,

PARTNER,

PRODUCT,

REG,

SCALE,

TECH

Пример:

["EXEC", "HIRE"]

signal_strengths

enum<string>[]

Доступные опции:

low,

medium,

high,

very_high

Пример:

["high"]

min_signal_count

integer

Минимальное количество сигналов экспансии, которое должно быть у компании за период — «очень активна / значительное присутствие».

Пример:

3

only_contraction

boolean

Если true, вернуть только экспансии с пометкой сокращения (компании, сворачивающие деятельность).

Пример:

false

min_markets

integer

Минимальное количество новых рынков, на которые должна была выйти компания за период.

Пример:

3

home_country_code

string[]

Фильтр по стране происхождения компании (ISO 3166-1 alpha-2). Пересекается с froms, если указаны оба.

Пример:

["SG"]

industries

string[]

Фильтр по названию отрасли (сопоставление по свободному тексту).

Пример:

["software", "financial services"]

exclude_industries

string[]

Отрасли для исключения (сопоставление по свободному тексту).

Пример:

["tobacco"]

verticals

integer[]

Список значений vertical_id, используемых для поиска компаний в конкретной отрасли. Чтобы найти ID, вызовите эндпоинт vertical на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["AI"].

vertical_categories

integer[]

Список значений vertical_category_id, используемых для поиска компаний в конкретной категории отрасли. Чтобы найти ID, вызовите эндпоинт vertical category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Information Technology"].

vertical_sub_categories

integer[]

Список значений vertical_sub_category_id, используемых для поиска компаний в конкретной подкатегории отрасли. Чтобы найти ID, вызовите эндпоинт vertical sub category на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Software"].

technologies

integer[]

Список значений tag_id, используемых для поиска конкретных технологий, применяемых компаниями. Чтобы найти ID, вызовите эндпоинт technology на вкладке Filters.

Этот фильтр поддерживает is_enable_similarity_search; при включении можно вводить произвольный текст, например ["Shopify"].

employees

string[][]

Диапазон количества сотрудников, работающих в компании. Позволяет находить компании по численности персонала. Можно добавить несколько диапазонов, чтобы расширить результаты поиска.

Подробнее см. эндпоинты company size на вкладке Filters.

Пример:

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

revenues

integer[]

Минимальный и максимальный диапазон выручки компании.

Пример:

[0, 100000]

founded_dates

integer[]

Диапазон годов основания компании. Максимальное значение — текущий год.

Пример:

[2018, 2024]

keywords

string[]

Список ключевых слов для фильтрации компаний по релевантности, специализациям или описаниям.

Пример:

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

companies

string[]

Ограничить конкретными компаниями по любому сочетанию domain_search_id, домена компании или URL профиля компании в социальных сетях. Домены и URL сопоставляются с наиболее подходящей компанией.

Пример:

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

job_locations

string[]

ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты location на вкладке Filters.

Пример:

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

job_exclude_locations

string[]

Географические местоположения, исключаемые из результатов поиска вакансий.

Пример:

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

job_posted_dates

string[]

Диапазон дат публикации вакансии. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:

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

job_titles

string[]

Должности, связанные с людьми, которых вы хотите найти.

Результаты также будут включать должности, содержащие схожую терминологию, даже если они не совпадают точно. Например, поиск по software engineer может вернуть результаты с должностью senior software engineer.

Пример:

["sales manager", "marketing manager"]

advertisement_target_locations

string[]

Целевые географические местоположения для рекламы.

Пример:

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

advertisement_exclude_target_locations

string[]

Географические местоположения, исключаемые из таргетинга рекламы.

Пример:

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

advertisement_search_terms

string[]

Ключевые слова, используемые для поиска в содержимом или заголовках рекламы.

Пример:

["asus"]

advertisement_start_dates

string<date>[]

Начало диапазона дат для фильтрации рекламы.

Пример:

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

advertisement_end_dates

string<date>[]

Конец диапазона дат для фильтрации рекламы.

Пример:

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

news_categories

string[]

Список category slugs для поиска конкретных категорий новостей. Чтобы найти слаг, вызовите эндпоинт news categories на вкладке Filters.

Пример:

["launches"]

news_published_dates

string[]

Диапазон дат публикации. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области.

Пример:

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

transitioned_dates

string<date>[]

Диапазон дат ISO для окна хронологии. По умолчанию — последние 90 дней. Запрос query на естественном языке также может задавать его через календарные фразы («в этом году», «в прошлом году», «второй квартал 2026»).

Пример:

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

window_days

integer

Необязательно. Размер скользящего окна в днях. Используется, когда явный диапазон transitioned_dates не указан; если не указаны оба, используется окно по умолчанию.

Пример:

90

query

string

Запрос на естественном языке, который Pubrio интерпретирует в фильтры экспансии и компании.

Пример:

"fintech companies expanding into the UK"

is_explain_match

boolean

Включить сгенерированные ИИ пояснения того, почему каждая компания соответствует поиску, основанные на реальных сигналах компании. Лучше всего сочетается с запросом на естественном языке. Количество цитируемых сигналов и размер пакета масштабируются вместе с per_page; источники с большим объёмом (вакансии, рекламные кампании) кратко представляются как количество за период (например, «12 вакансий»), а не перечисляются по отдельности.

Пример:

true

sort_by

enum<string>

Порядок результатов. Не указывайте для порядка по релевантности по умолчанию: сначала подтверждённые пары (2+ разных типов сигналов), затем пары с повторяющимися подтверждениями (3+ сигнала), затем остальные — внутри каждого уровня сначала недавно перешедшие. recent — по чистой актуальности (сначала недавно перешедшие). expansion_score — сначала с наивысшим показателем экспансии. signal_count — сначала с наибольшим числом сигналов в паре. company_ranking — общий рейтинг компании в Pubrio (меньше — заметнее), по возрастанию.

Доступные опции:

recent,

expansion_score,

signal_count,

company_ranking

Пример:

"expansion_score"

is_include_metadata

boolean

Вернуть полную детализированную полезную нагрузку. По умолчанию трафик по ключу API компактный: блок model, показатели достоверности (stage.confidence в Company Expansion Detail, confidence_score в other_markets[] и в markers[] Rankings), а также поля established_min / share_of_detected / has_known_office опускаются, если это значение не true.

Пример:

true

page

integer

по умолчанию:1

Номер страницы, начиная с 1. Предел определяется параметром max_search_page вашей подписки (max_company_search_page для поиска компаний), который возвращает Profile. Превышение возвращает HTTP 416.

Пример:

1

per_page

integer

по умолчанию:25

Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром max_search_per_page вашей подписки, который возвращает Profile. Превышение возвращает HTTP 416 с кодом 41676 (или 41613 для поиска компаний и людей), а не усечённый набор результатов.

Требуемый диапазон: x <= 25

Пример:

25

is_enable_similarity_search

boolean

Включить сопоставление по свободному тексту для verticals, vertical_categories, vertical_sub_categories и technologies; эти фильтры отбрасываются, если это значение не true.

Пример:

true

Ответ

Постраничный список компаний, выходящих на рынок(и). filters отражает применённые (или интерпретированные из естественного языка) критерии; каждая компания включает match_summary, если is_explain_match равен true.

metadata

object

Метаданные поиска: фактически применённые фильтры, а также сводка по рынку (агрегат, географический охват, топ источников/направлений/отраслей, хронология). Ответы по ключу API включают сводку только если is_include_metadata равен true.

Show child attributes

data

object

Контейнер результатов (стандартная оболочка поиска): список компаний плюс данные пагинации.

Show child attributes

Последнее изменение 4 сентября 2026 г.

Документация API

Конечные точки

Поиск экспансии

Авторизации

Тело

Ответ