Batch Company Expansion Summaries

Batch company expansion summaries

curl --request POST \
  --url https://api.pubrio.com/expansions/companies/summaries \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "companies": [
    "stripe.com",
    "https://www.linkedin.com/company/airbnb",
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "transitioned_dates": [
    "2026-04-01",
    "2026-06-29"
  ],
  "window_days": 90,
  "is_include_established": false,
  "is_include_metadata": true
}
'

import requests

url = "https://api.pubrio.com/expansions/companies/summaries"

payload = {
    "companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "550e8400-e29b-41d4-a716-446655440000"],
    "domains": ["pubrio.com"],
    "linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
    "transitioned_dates": ["2026-04-01", "2026-06-29"],
    "window_days": 90,
    "is_include_established": False,
    "is_include_metadata": 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({
    companies: [
      'stripe.com',
      'https://www.linkedin.com/company/airbnb',
      '550e8400-e29b-41d4-a716-446655440000'
    ],
    domains: ['pubrio.com'],
    linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
    transitioned_dates: ['2026-04-01', '2026-06-29'],
    window_days: 90,
    is_include_established: false,
    is_include_metadata: true
  })
};

fetch('https://api.pubrio.com/expansions/companies/summaries', 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/companies/summaries",
  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([
    'companies' => [
        'stripe.com',
        'https://www.linkedin.com/company/airbnb',
        '550e8400-e29b-41d4-a716-446655440000'
    ],
    'domains' => [
        'pubrio.com'
    ],
    'linkedin_urls' => [
        'https://www.linkedin.com/company/pubrio'
    ],
    'transitioned_dates' => [
        '2026-04-01',
        '2026-06-29'
    ],
    'window_days' => 90,
    'is_include_established' => false,
    'is_include_metadata' => 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/companies/summaries"

	payload := strings.NewReader("{\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"is_include_established\": false,\n  \"is_include_metadata\": 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/companies/summaries")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"is_include_established\": false,\n  \"is_include_metadata\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"is_include_established\": false,\n  \"is_include_metadata\": true\n}"

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

{
  "metadata": {},
  "data": {
    "companies": [
      {
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "home_country_code": "SG",
        "expansion_score": 82,
        "firmographics": {
          "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
          "company_name": "Example Corp",
          "domain": "example.com",
          "logo_url": "https://logo.pubrio.com/example.com.png",
          "country_code": "SG",
          "company_size": null,
          "employees_count": 350,
          "company_size_printed": "351+",
          "is_employees_locked": false,
          "founded_year": 2015,
          "industry": "Software Development",
          "publicly_traded_symbol": null,
          "estimated_revenue": 25000000
        },
        "markets_summary": [
          {
            "country_code": "US",
            "stage_slug": "committing",
            "signal_count": 12,
            "distinct_type_count": 4,
            "first_signal_at": "2026-04-02T08:00:00.000Z",
            "latest_signal_at": "2026-06-28T10:15:22.000Z",
            "last_transition_at": "2026-06-25T14:30:00.000Z",
            "expansion_score": 0.685,
            "signals": [
              {
                "signal_type_slug": "EXEC",
                "signal_subtype_slug": "country_manager",
                "event_date": "2026-06-20T14:00:00.000Z",
                "display_label": "Hired Regional VP for North America"
              }
            ]
          }
        ],
        "signal_weekly_totals": [
          {
            "week_start": "2026-06-22",
            "signal_type_slug": "HIRE",
            "count": 5
          }
        ],
        "summary": {
          "active_markets": 1,
          "total_markets": 1,
          "new_markets": 1,
          "momentum_pct": 22,
          "signal_count": 12,
          "window_expansion_score": 69,
          "scaling": 0,
          "pipeline": 1,
          "top_market": {
            "country_code": "US",
            "country": null,
            "stage": "committing"
          },
          "newest_market": {
            "country_code": "US",
            "country": null,
            "stage": "committing"
          },
          "activity_weekly": [
            3,
            5,
            4
          ]
        }
      }
    ]
  }
}

POST

expansions

companies

summaries

Batch company expansion summaries

curl --request POST \
  --url https://api.pubrio.com/expansions/companies/summaries \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "companies": [
    "stripe.com",
    "https://www.linkedin.com/company/airbnb",
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "domains": [
    "pubrio.com"
  ],
  "linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "transitioned_dates": [
    "2026-04-01",
    "2026-06-29"
  ],
  "window_days": 90,
  "is_include_established": false,
  "is_include_metadata": true
}
'

import requests

url = "https://api.pubrio.com/expansions/companies/summaries"

payload = {
    "companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "550e8400-e29b-41d4-a716-446655440000"],
    "domains": ["pubrio.com"],
    "linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
    "transitioned_dates": ["2026-04-01", "2026-06-29"],
    "window_days": 90,
    "is_include_established": False,
    "is_include_metadata": 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({
    companies: [
      'stripe.com',
      'https://www.linkedin.com/company/airbnb',
      '550e8400-e29b-41d4-a716-446655440000'
    ],
    domains: ['pubrio.com'],
    linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
    transitioned_dates: ['2026-04-01', '2026-06-29'],
    window_days: 90,
    is_include_established: false,
    is_include_metadata: true
  })
};

fetch('https://api.pubrio.com/expansions/companies/summaries', 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/companies/summaries",
  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([
    'companies' => [
        'stripe.com',
        'https://www.linkedin.com/company/airbnb',
        '550e8400-e29b-41d4-a716-446655440000'
    ],
    'domains' => [
        'pubrio.com'
    ],
    'linkedin_urls' => [
        'https://www.linkedin.com/company/pubrio'
    ],
    'transitioned_dates' => [
        '2026-04-01',
        '2026-06-29'
    ],
    'window_days' => 90,
    'is_include_established' => false,
    'is_include_metadata' => 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/companies/summaries"

	payload := strings.NewReader("{\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"is_include_established\": false,\n  \"is_include_metadata\": 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/companies/summaries")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"is_include_established\": false,\n  \"is_include_metadata\": true\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"companies\": [\n    \"stripe.com\",\n    \"https://www.linkedin.com/company/airbnb\",\n    \"550e8400-e29b-41d4-a716-446655440000\"\n  ],\n  \"domains\": [\n    \"pubrio.com\"\n  ],\n  \"linkedin_urls\": [\n    \"https://www.linkedin.com/company/pubrio\"\n  ],\n  \"transitioned_dates\": [\n    \"2026-04-01\",\n    \"2026-06-29\"\n  ],\n  \"window_days\": 90,\n  \"is_include_established\": false,\n  \"is_include_metadata\": true\n}"

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

{
  "metadata": {},
  "data": {
    "companies": [
      {
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "home_country_code": "SG",
        "expansion_score": 82,
        "firmographics": {
          "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
          "company_name": "Example Corp",
          "domain": "example.com",
          "logo_url": "https://logo.pubrio.com/example.com.png",
          "country_code": "SG",
          "company_size": null,
          "employees_count": 350,
          "company_size_printed": "351+",
          "is_employees_locked": false,
          "founded_year": 2015,
          "industry": "Software Development",
          "publicly_traded_symbol": null,
          "estimated_revenue": 25000000
        },
        "markets_summary": [
          {
            "country_code": "US",
            "stage_slug": "committing",
            "signal_count": 12,
            "distinct_type_count": 4,
            "first_signal_at": "2026-04-02T08:00:00.000Z",
            "latest_signal_at": "2026-06-28T10:15:22.000Z",
            "last_transition_at": "2026-06-25T14:30:00.000Z",
            "expansion_score": 0.685,
            "signals": [
              {
                "signal_type_slug": "EXEC",
                "signal_subtype_slug": "country_manager",
                "event_date": "2026-06-20T14:00:00.000Z",
                "display_label": "Hired Regional VP for North America"
              }
            ]
          }
        ],
        "signal_weekly_totals": [
          {
            "week_start": "2026-06-22",
            "signal_type_slug": "HIRE",
            "count": 5
          }
        ],
        "summary": {
          "active_markets": 1,
          "total_markets": 1,
          "new_markets": 1,
          "momentum_pct": 22,
          "signal_count": 12,
          "window_expansion_score": 69,
          "scaling": 0,
          "pipeline": 1,
          "top_market": {
            "country_code": "US",
            "country": null,
            "stage": "committing"
          },
          "newest_market": {
            "country_code": "US",
            "country": null,
            "stage": "committing"
          },
          "activity_weekly": [
            3,
            5,
            4
          ]
        }
      }
    ]
  }
}

Authorizations

pubrio-api-key

string

header

required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json

Scope companies with a single companies array of mixed identifiers — domain_search_id, company domain, or LinkedIn URL — matched as a union (not intersected). The legacy domain_search_ids, domains, and linkedin_urls keys remain accepted for backward compatibility. Up to 25 resolved companies per request.

companies

string[]

Scope to specific companies by any mix of domain_search_id, company domain, or a company social media profile URL. Domains and URLs resolve to their best-ranked company.

Example:

[
  "stripe.com",
  "https://www.linkedin.com/company/airbnb",
  "550e8400-e29b-41d4-a716-446655440000"
]

domains

string[]

List of company domains used for company and people search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.

Example:

["pubrio.com"]

linkedin_urls

string[]

The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/

Example:

["https://www.linkedin.com/company/pubrio"]

transitioned_dates

string<date>[]

ISO [from, to] date range for the signal/transition window. Takes precedence over window_days when both are supplied.

Example:

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

window_days

integer

Optional. Size of the rolling window in days. Used when an explicit transitioned_dates range is not supplied; if both are omitted, a default window is used.

Example:

90

is_include_established

boolean

Include the established stage (long-standing operators with no active expansion signals). Defaults to false.

Example:

false

is_include_metadata

boolean

Return the full detail payload. API-key traffic is lean by default: the model block, the confidence figures (stage.confidence on Company Expansion Detail, confidence_score on other_markets[] and on Rankings markers[]) and the established_min / share_of_detected / has_known_office fields are all omitted unless this is true.

Example:

true

Response

200 - application/json

Array of per-company expansion summaries. Two scores: top-level expansion_score is the overall current posture across all markets (stable); summary.window_expansion_score is the same measure scoped to the selected window. Both are on a 0-100 scale here (unlike the 0-1 stage.expansion_score on search results). When your plan does not include employee counts, firmographics returns company_size, employees_count, and company_size_printed as null and sets is_employees_locked: true.

metadata

object

data

object

Show child attributes

API Documentation

Endpoint

Authorizations

Body

Response