Try processing a monitor
curl --request POST \
--url https://api.pubrio.com/monitors/process/try \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"monitor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tried_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"signal_types": [
"<string>"
],
"signal_filters": [
{}
],
"company_filters": {},
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"<string>"
],
"linkedin_urls": [
"<string>"
],
"is_company_enrichment": true,
"is_people_enrichment": true,
"people_enrichment_configs": [
{}
],
"destination_config": {},
"max_records_per_trigger": 123,
"excluded_companies": [
"550e8400-e29b-41d4-a716-446655440002"
],
"excluded_domains": [
"existing-client.com"
],
"excluded_linkedin_urls": [
"https://linkedin.com/company/existing-client"
],
"record_unit": "company",
"company_dedupe_days": 30,
"is_newest_first": true
}
'import requests
url = "https://api.pubrio.com/monitors/process/try"
payload = {
"monitor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tried_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"signal_types": ["<string>"],
"signal_filters": [{}],
"company_filters": {},
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["<string>"],
"linkedin_urls": ["<string>"],
"is_company_enrichment": True,
"is_people_enrichment": True,
"people_enrichment_configs": [{}],
"destination_config": {},
"max_records_per_trigger": 123,
"excluded_companies": ["550e8400-e29b-41d4-a716-446655440002"],
"excluded_domains": ["existing-client.com"],
"excluded_linkedin_urls": ["https://linkedin.com/company/existing-client"],
"record_unit": "company",
"company_dedupe_days": 30,
"is_newest_first": 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({
monitor_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
tried_at: '2023-11-07T05:31:56Z',
name: '<string>',
signal_types: ['<string>'],
signal_filters: [{}],
company_filters: {},
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['<string>'],
linkedin_urls: ['<string>'],
is_company_enrichment: true,
is_people_enrichment: true,
people_enrichment_configs: [{}],
destination_config: {},
max_records_per_trigger: 123,
excluded_companies: ['550e8400-e29b-41d4-a716-446655440002'],
excluded_domains: ['existing-client.com'],
excluded_linkedin_urls: ['https://linkedin.com/company/existing-client'],
record_unit: 'company',
company_dedupe_days: 30,
is_newest_first: true
})
};
fetch('https://api.pubrio.com/monitors/process/try', 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/monitors/process/try",
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([
'monitor_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'tried_at' => '2023-11-07T05:31:56Z',
'name' => '<string>',
'signal_types' => [
'<string>'
],
'signal_filters' => [
[
]
],
'company_filters' => [
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'<string>'
],
'linkedin_urls' => [
'<string>'
],
'is_company_enrichment' => true,
'is_people_enrichment' => true,
'people_enrichment_configs' => [
[
]
],
'destination_config' => [
],
'max_records_per_trigger' => 123,
'excluded_companies' => [
'550e8400-e29b-41d4-a716-446655440002'
],
'excluded_domains' => [
'existing-client.com'
],
'excluded_linkedin_urls' => [
'https://linkedin.com/company/existing-client'
],
'record_unit' => 'company',
'company_dedupe_days' => 30,
'is_newest_first' => 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/monitors/process/try"
payload := strings.NewReader("{\n \"monitor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tried_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"signal_types\": [\n \"<string>\"\n ],\n \"signal_filters\": [\n {}\n ],\n \"company_filters\": {},\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"<string>\"\n ],\n \"linkedin_urls\": [\n \"<string>\"\n ],\n \"is_company_enrichment\": true,\n \"is_people_enrichment\": true,\n \"people_enrichment_configs\": [\n {}\n ],\n \"destination_config\": {},\n \"max_records_per_trigger\": 123,\n \"excluded_companies\": [\n \"550e8400-e29b-41d4-a716-446655440002\"\n ],\n \"excluded_domains\": [\n \"existing-client.com\"\n ],\n \"excluded_linkedin_urls\": [\n \"https://linkedin.com/company/existing-client\"\n ],\n \"record_unit\": \"company\",\n \"company_dedupe_days\": 30,\n \"is_newest_first\": 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/monitors/process/try")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"monitor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tried_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"signal_types\": [\n \"<string>\"\n ],\n \"signal_filters\": [\n {}\n ],\n \"company_filters\": {},\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"<string>\"\n ],\n \"linkedin_urls\": [\n \"<string>\"\n ],\n \"is_company_enrichment\": true,\n \"is_people_enrichment\": true,\n \"people_enrichment_configs\": [\n {}\n ],\n \"destination_config\": {},\n \"max_records_per_trigger\": 123,\n \"excluded_companies\": [\n \"550e8400-e29b-41d4-a716-446655440002\"\n ],\n \"excluded_domains\": [\n \"existing-client.com\"\n ],\n \"excluded_linkedin_urls\": [\n \"https://linkedin.com/company/existing-client\"\n ],\n \"record_unit\": \"company\",\n \"company_dedupe_days\": 30,\n \"is_newest_first\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/monitors/process/try")
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 \"monitor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tried_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"signal_types\": [\n \"<string>\"\n ],\n \"signal_filters\": [\n {}\n ],\n \"company_filters\": {},\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"<string>\"\n ],\n \"linkedin_urls\": [\n \"<string>\"\n ],\n \"is_company_enrichment\": true,\n \"is_people_enrichment\": true,\n \"people_enrichment_configs\": [\n {}\n ],\n \"destination_config\": {},\n \"max_records_per_trigger\": 123,\n \"excluded_companies\": [\n \"550e8400-e29b-41d4-a716-446655440002\"\n ],\n \"excluded_domains\": [\n \"existing-client.com\"\n ],\n \"excluded_linkedin_urls\": [\n \"https://linkedin.com/company/existing-client\"\n ],\n \"record_unit\": \"company\",\n \"company_dedupe_days\": 30,\n \"is_newest_first\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "success",
"total_signals": 25,
"total_credit": 59,
"processing_time_ms": 99050,
"delivery_result": {
"is_success": true,
"error_message": null,
"response_status_code": 200,
"response_payload": "OK",
"retry_attempt": 0
}
}
}{
"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."
}Process
Monitor Process Try
Run a saved monitor by id, or run an unsaved ad-hoc configuration by passing the config inline; with monitor_id, inline fields override the saved monitor for this run.
POST
/
monitors
/
process
/
try
Try processing a monitor
curl --request POST \
--url https://api.pubrio.com/monitors/process/try \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"monitor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tried_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"signal_types": [
"<string>"
],
"signal_filters": [
{}
],
"company_filters": {},
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"<string>"
],
"linkedin_urls": [
"<string>"
],
"is_company_enrichment": true,
"is_people_enrichment": true,
"people_enrichment_configs": [
{}
],
"destination_config": {},
"max_records_per_trigger": 123,
"excluded_companies": [
"550e8400-e29b-41d4-a716-446655440002"
],
"excluded_domains": [
"existing-client.com"
],
"excluded_linkedin_urls": [
"https://linkedin.com/company/existing-client"
],
"record_unit": "company",
"company_dedupe_days": 30,
"is_newest_first": true
}
'import requests
url = "https://api.pubrio.com/monitors/process/try"
payload = {
"monitor_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tried_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"signal_types": ["<string>"],
"signal_filters": [{}],
"company_filters": {},
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["<string>"],
"linkedin_urls": ["<string>"],
"is_company_enrichment": True,
"is_people_enrichment": True,
"people_enrichment_configs": [{}],
"destination_config": {},
"max_records_per_trigger": 123,
"excluded_companies": ["550e8400-e29b-41d4-a716-446655440002"],
"excluded_domains": ["existing-client.com"],
"excluded_linkedin_urls": ["https://linkedin.com/company/existing-client"],
"record_unit": "company",
"company_dedupe_days": 30,
"is_newest_first": 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({
monitor_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
tried_at: '2023-11-07T05:31:56Z',
name: '<string>',
signal_types: ['<string>'],
signal_filters: [{}],
company_filters: {},
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['<string>'],
linkedin_urls: ['<string>'],
is_company_enrichment: true,
is_people_enrichment: true,
people_enrichment_configs: [{}],
destination_config: {},
max_records_per_trigger: 123,
excluded_companies: ['550e8400-e29b-41d4-a716-446655440002'],
excluded_domains: ['existing-client.com'],
excluded_linkedin_urls: ['https://linkedin.com/company/existing-client'],
record_unit: 'company',
company_dedupe_days: 30,
is_newest_first: true
})
};
fetch('https://api.pubrio.com/monitors/process/try', 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/monitors/process/try",
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([
'monitor_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'tried_at' => '2023-11-07T05:31:56Z',
'name' => '<string>',
'signal_types' => [
'<string>'
],
'signal_filters' => [
[
]
],
'company_filters' => [
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'<string>'
],
'linkedin_urls' => [
'<string>'
],
'is_company_enrichment' => true,
'is_people_enrichment' => true,
'people_enrichment_configs' => [
[
]
],
'destination_config' => [
],
'max_records_per_trigger' => 123,
'excluded_companies' => [
'550e8400-e29b-41d4-a716-446655440002'
],
'excluded_domains' => [
'existing-client.com'
],
'excluded_linkedin_urls' => [
'https://linkedin.com/company/existing-client'
],
'record_unit' => 'company',
'company_dedupe_days' => 30,
'is_newest_first' => 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/monitors/process/try"
payload := strings.NewReader("{\n \"monitor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tried_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"signal_types\": [\n \"<string>\"\n ],\n \"signal_filters\": [\n {}\n ],\n \"company_filters\": {},\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"<string>\"\n ],\n \"linkedin_urls\": [\n \"<string>\"\n ],\n \"is_company_enrichment\": true,\n \"is_people_enrichment\": true,\n \"people_enrichment_configs\": [\n {}\n ],\n \"destination_config\": {},\n \"max_records_per_trigger\": 123,\n \"excluded_companies\": [\n \"550e8400-e29b-41d4-a716-446655440002\"\n ],\n \"excluded_domains\": [\n \"existing-client.com\"\n ],\n \"excluded_linkedin_urls\": [\n \"https://linkedin.com/company/existing-client\"\n ],\n \"record_unit\": \"company\",\n \"company_dedupe_days\": 30,\n \"is_newest_first\": 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/monitors/process/try")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"monitor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tried_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"signal_types\": [\n \"<string>\"\n ],\n \"signal_filters\": [\n {}\n ],\n \"company_filters\": {},\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"<string>\"\n ],\n \"linkedin_urls\": [\n \"<string>\"\n ],\n \"is_company_enrichment\": true,\n \"is_people_enrichment\": true,\n \"people_enrichment_configs\": [\n {}\n ],\n \"destination_config\": {},\n \"max_records_per_trigger\": 123,\n \"excluded_companies\": [\n \"550e8400-e29b-41d4-a716-446655440002\"\n ],\n \"excluded_domains\": [\n \"existing-client.com\"\n ],\n \"excluded_linkedin_urls\": [\n \"https://linkedin.com/company/existing-client\"\n ],\n \"record_unit\": \"company\",\n \"company_dedupe_days\": 30,\n \"is_newest_first\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/monitors/process/try")
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 \"monitor_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"tried_at\": \"2023-11-07T05:31:56Z\",\n \"name\": \"<string>\",\n \"signal_types\": [\n \"<string>\"\n ],\n \"signal_filters\": [\n {}\n ],\n \"company_filters\": {},\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"<string>\"\n ],\n \"linkedin_urls\": [\n \"<string>\"\n ],\n \"is_company_enrichment\": true,\n \"is_people_enrichment\": true,\n \"people_enrichment_configs\": [\n {}\n ],\n \"destination_config\": {},\n \"max_records_per_trigger\": 123,\n \"excluded_companies\": [\n \"550e8400-e29b-41d4-a716-446655440002\"\n ],\n \"excluded_domains\": [\n \"existing-client.com\"\n ],\n \"excluded_linkedin_urls\": [\n \"https://linkedin.com/company/existing-client\"\n ],\n \"record_unit\": \"company\",\n \"company_dedupe_days\": 30,\n \"is_newest_first\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"monitor_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "success",
"total_signals": 25,
"total_credit": 59,
"processing_time_ms": 99050,
"delivery_result": {
"is_success": true,
"error_message": null,
"response_status_code": 200,
"response_payload": "OK",
"retry_attempt": 0
}
}
}{
"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."
}Authorizations
Body
application/json
Optional. Unique identifier of a saved monitor to trigger. Omit it to run an unsaved ad-hoc configuration passed inline.
Timestamp to use as the scan reference point. Use a recent past date to ensure data availability for testing. Using current time may return 0 results.
Name for the run configuration.
Detection mode for the run.
Available options:
company_first, signal_first Signal types to scan (jobs, news, advertisements, expansions).
Per-signal-type filter objects, same shape as Create Monitor.
Global company filters, same parameters as Company Search.
Company domain_search_id UUIDs to scan.
Company domains to scan — resolved to companies.
LinkedIn company URLs to scan — resolved to companies.
Whether to enrich company data in results.
Whether to enrich people data in results.
People enrichment layers, same shape as Create Monitor.
Delivery destination type for the run.
Available options:
webhook, email, sequences Destination configuration for the run, same shape as Create Monitor.
Maximum records delivered by this run.
Companies to exclude from this run (domain_search_id UUIDs); also excluded_domains / excluded_linkedin_urls.
Example:
["550e8400-e29b-41d4-a716-446655440002"]
Company domains to exclude (e.g. ["existing-client.com"]). Resolved to companies and merged into excluded_companies.
Example:
["existing-client.com"]
LinkedIn company URLs to exclude. Resolved to companies and merged into excluded_companies.
Example:
[
"https://linkedin.com/company/existing-client"
]
Record unit for this run: signal or company.
Available options:
signal, company Example:
"company"
Company dedupe window in days for this run (saved monitors only; reads the monitor's delivery history).
Required range:
x >= 0Example:
30
Deliver the freshest matching signals first. With a per-trigger or daily cap the newest records are kept and the monitor's cursor still moves to the newest fetched row, so older rows are skipped, never queued. Default false (oldest first, nothing skipped).
Example:
true
Last modified on April 5, 2026