Unternehmens-Signalereignisse
curl --request POST \
--url https://api.pubrio.com/expansions/companies/pulse_events \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_types": [
"EXEC",
"HIRE"
],
"country_codes": [
"JP",
"SG"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"query": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.",
"is_explain_match": true,
"domain": "pubrio.com",
"linkedin_url": "https://www.linkedin.com/company/pubrio",
"page": 1,
"per_page": 25
}
'import requests
url = "https://api.pubrio.com/expansions/companies/pulse_events"
payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_types": ["EXEC", "HIRE"],
"country_codes": ["JP", "SG"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"query": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.",
"is_explain_match": True,
"domain": "pubrio.com",
"linkedin_url": "https://www.linkedin.com/company/pubrio",
"page": 1,
"per_page": 25
}
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({
domain_search_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
signal_types: ['EXEC', 'HIRE'],
country_codes: ['JP', 'SG'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
query: 'We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.',
is_explain_match: true,
domain: 'pubrio.com',
linkedin_url: 'https://www.linkedin.com/company/pubrio',
page: 1,
per_page: 25
})
};
fetch('https://api.pubrio.com/expansions/companies/pulse_events', 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/pulse_events",
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([
'domain_search_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'signal_types' => [
'EXEC',
'HIRE'
],
'country_codes' => [
'JP',
'SG'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'query' => 'We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.',
'is_explain_match' => true,
'domain' => 'pubrio.com',
'linkedin_url' => 'https://www.linkedin.com/company/pubrio',
'page' => 1,
'per_page' => 25
]),
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/pulse_events"
payload := strings.NewReader("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"country_codes\": [\n \"JP\",\n \"SG\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.\",\n \"is_explain_match\": true,\n \"domain\": \"pubrio.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/pubrio\",\n \"page\": 1,\n \"per_page\": 25\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/pulse_events")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"country_codes\": [\n \"JP\",\n \"SG\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.\",\n \"is_explain_match\": true,\n \"domain\": \"pubrio.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/pubrio\",\n \"page\": 1,\n \"per_page\": 25\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/companies/pulse_events")
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 \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"country_codes\": [\n \"JP\",\n \"SG\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.\",\n \"is_explain_match\": true,\n \"domain\": \"pubrio.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/pubrio\",\n \"page\": 1,\n \"per_page\": 25\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
}
},
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 42,
"total_pages": 2,
"total_display_pages": 2,
"is_timeout": false
},
"events": [
{
"signal_type_slug": "EXEC",
"stage_slug": "expanding",
"country_code": "US",
"signal_subtype_slug": "country_manager",
"source_type": "linkedin",
"polarity": "expansion",
"display_label": "Hired Country Manager",
"evidence_url": "https://linkedin.com/company/example-corp",
"event_date": "2026-06-20T14:00:00.000Z"
}
],
"summary": {
"text": "Example Corp is hiring across Tokyo[1] and just added a Japan Country Manager[2], yet has no legal entity on file — it is staffing the market before incorporating, which is exactly your window.",
"citations": [
{
"n": 1,
"type": "HIRE",
"label": "Tokyo software & field-ops roles",
"country": "JP",
"date": "2026-06",
"url": null
},
{
"n": 2,
"type": "EXEC",
"label": "Country Manager, Japan",
"country": "JP",
"date": "2026-06",
"url": "https://linkedin.com/in/example"
}
]
}
}
}{
"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."
}Expansion
Unternehmens-Signalereignisse
Angereicherter, paginierter Drilldown in die Signalereignisse, die die Expansion eines einzelnen Unternehmens antreiben.
POST
/
expansions
/
companies
/
pulse_events
Unternehmens-Signalereignisse
curl --request POST \
--url https://api.pubrio.com/expansions/companies/pulse_events \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_types": [
"EXEC",
"HIRE"
],
"country_codes": [
"JP",
"SG"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"query": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.",
"is_explain_match": true,
"domain": "pubrio.com",
"linkedin_url": "https://www.linkedin.com/company/pubrio",
"page": 1,
"per_page": 25
}
'import requests
url = "https://api.pubrio.com/expansions/companies/pulse_events"
payload = {
"domain_search_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_types": ["EXEC", "HIRE"],
"country_codes": ["JP", "SG"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"query": "We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.",
"is_explain_match": True,
"domain": "pubrio.com",
"linkedin_url": "https://www.linkedin.com/company/pubrio",
"page": 1,
"per_page": 25
}
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({
domain_search_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
signal_types: ['EXEC', 'HIRE'],
country_codes: ['JP', 'SG'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
query: 'We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.',
is_explain_match: true,
domain: 'pubrio.com',
linkedin_url: 'https://www.linkedin.com/company/pubrio',
page: 1,
per_page: 25
})
};
fetch('https://api.pubrio.com/expansions/companies/pulse_events', 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/pulse_events",
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([
'domain_search_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'signal_types' => [
'EXEC',
'HIRE'
],
'country_codes' => [
'JP',
'SG'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'query' => 'We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.',
'is_explain_match' => true,
'domain' => 'pubrio.com',
'linkedin_url' => 'https://www.linkedin.com/company/pubrio',
'page' => 1,
'per_page' => 25
]),
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/pulse_events"
payload := strings.NewReader("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"country_codes\": [\n \"JP\",\n \"SG\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.\",\n \"is_explain_match\": true,\n \"domain\": \"pubrio.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/pubrio\",\n \"page\": 1,\n \"per_page\": 25\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/pulse_events")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"country_codes\": [\n \"JP\",\n \"SG\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.\",\n \"is_explain_match\": true,\n \"domain\": \"pubrio.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/pubrio\",\n \"page\": 1,\n \"per_page\": 25\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/companies/pulse_events")
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 \"domain_search_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"country_codes\": [\n \"JP\",\n \"SG\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity.\",\n \"is_explain_match\": true,\n \"domain\": \"pubrio.com\",\n \"linkedin_url\": \"https://www.linkedin.com/company/pubrio\",\n \"page\": 1,\n \"per_page\": 25\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c"
}
},
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 42,
"total_pages": 2,
"total_display_pages": 2,
"is_timeout": false
},
"events": [
{
"signal_type_slug": "EXEC",
"stage_slug": "expanding",
"country_code": "US",
"signal_subtype_slug": "country_manager",
"source_type": "linkedin",
"polarity": "expansion",
"display_label": "Hired Country Manager",
"evidence_url": "https://linkedin.com/company/example-corp",
"event_date": "2026-06-20T14:00:00.000Z"
}
],
"summary": {
"text": "Example Corp is hiring across Tokyo[1] and just added a Japan Country Manager[2], yet has no legal entity on file — it is staffing the market before incorporating, which is exactly your window.",
"citations": [
{
"n": 1,
"type": "HIRE",
"label": "Tokyo software & field-ops roles",
"country": "JP",
"date": "2026-06",
"url": null
},
{
"n": 2,
"type": "EXEC",
"label": "Country Manager, Japan",
"country": "JP",
"date": "2026-06",
"url": "https://linkedin.com/in/example"
}
]
}
}
}{
"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."
}Autorisierungen
Body
application/json
- Domain Search ID
- Domain
- LinkedIn URL
Eine eindeutige Kennung für den Unternehmenssuchvorgang.
Filtert auf bestimmte Signaltypen. Definitionen und Stufen finden Sie im Katalog „Signal Types“ in der Wissensdatenbank (DNS und INFRA sind Signale der Premier-Stufe).
Verfügbare Optionen:
AD, AUDIENCE, DNS, ENTITY, EVENT, EVENT_PLUS, EXEC, HIRE, INFRA, IP, NEWS, OFFICE, PARTNER, PRODUCT, REG, SCALE, TECH Beispiel:
["EXEC", "HIRE"]
Optional. Schränkt den Feed auf einen oder mehrere ausländische Märkte ein (ISO 3166-1 Alpha-2, z. B. ["JP","SG"]). Weggelassen → alle ausländischen Märkte (der Heimatmarkt wird stets ausgeschlossen).
Beispiel:
["JP", "SG"]
ISO-[from, to]-Datumsbereich für das Signal-/Übergangsfenster. Hat Vorrang vor window_days, wenn beide angegeben werden.
Beispiel:
["2026-04-01", "2026-06-29"]
Optional. Größe des gleitenden Ereignisfensters in Tagen. Standardmäßig 90 (das Standard-Anzeigefenster), wenn weder dieser Parameter noch transitioned_dates angegeben wird. Werden beide gesendet, hat transitioned_dates Vorrang.
Beispiel:
90
Beschreibung in natürlicher Sprache dessen, was Sie verkaufen, oder des Käuferprofils, gegen das Sie dieses Unternehmen bewerten. Wird nur verwendet, um die KI-summary zu fundieren (siehe is_explain_match); anders als bei der Unternehmenssuche wird sie hier NICHT in Filter interpretiert.
Beispiel:
"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."
Bei true und angegebener query liefert data.summary eine einzelne KI-Zusammenfassung der Expansionsaktivität dieses Unternehmens im Abgleich mit Ihrer query, gestützt auf die tatsächlichen Signale des Unternehmens mit [n]-Zitaten. Anders als das unternehmensbezogene match_summary der Unternehmenssuche wird diese Zusammenfassung aus dem GESAMTEN Feed des Unternehmens für das Fenster erstellt (alle Märkte, jedes Signal) und bleibt daher unabhängig von page / per_page stabil.
Beispiel:
true
Eine Unternehmensdomain für Unternehmenssuchvorgänge. Erhalten wir eine URL wie www.pubrio.com oder https://docs.pubrio.com/, wandelt das System diese zur Verarbeitung in pubrio.com um.
Beispiel:
"pubrio.com"
Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit http und enthält linkedin.com/company/
Beispiel:
"https://www.linkedin.com/company/pubrio"
Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch die Obergrenze ist — das Limit ist der max_search_per_page-Wert Ihres Abonnements, zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 mit dem Code 41676 (oder 41613 bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge.
Erforderlicher Bereich:
x <= 25Beispiel:
25
Antwort
Paginierte Signalereignisse. Wenn is_explain_match den Wert true hat und eine query angegeben wird, enthält data.summary eine KI-Zusammenfassung ({ text, citations }) der Gesamt-Feed-Aktivität des Unternehmens im Abgleich mit der Anfrage; andernfalls ist es null.
Zuletzt geändert am 4. September 2026