Criar um monitor
curl --request POST \
--url https://api.pubrio.com/monitors/create \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"query": "<string>",
"name": "<string>",
"description": "<string>",
"status": "active",
"signal_types": [],
"signal_filters": [
{
"signal_type": "jobs",
"filters": {
"locations": [
"US"
]
}
},
{
"signal_type": "news",
"filters": {
"locations": [
"US"
]
}
},
{
"signal_type": "advertisements",
"filters": {
"target_locations": [
"US"
]
}
},
{
"signal_type": "expansions",
"filters": {
"tos": [
"US"
],
"stages": [
"expanding",
"scaling"
],
"signal_types": [
"HIRE",
"EXEC"
],
"signal_strengths": [
"high",
"very_high"
]
}
}
],
"company_filters": {
"locations": [
"US"
],
"employees": [
[
501,
1000
],
[
1001,
5000
]
]
},
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"<string>"
],
"linkedin_urls": [
"<string>"
],
"is_company_enrichment": true,
"is_people_enrichment": true,
"people_enrichment_configs": [
{
"filters": {
"people_locations": [
"US"
]
},
"max_people_to_return": 3,
"people_contact_types": [
"email-work"
]
}
],
"destination_config": {
"webhook_url": "https://your-webhook.com/endpoint",
"headers": {
"Authorization": "Bearer token"
},
"body": {
"pipeline": "my-webhook"
}
},
"frequency_minute": 0,
"max_failure_trigger": 5,
"max_daily_trigger": 500,
"max_records_per_trigger": 25,
"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,
"max_daily_records": 200,
"notification_email": "[email protected]",
"max_retry_per_trigger": 1,
"retry_delay_second": 1,
"deep": true
}
'import requests
url = "https://api.pubrio.com/monitors/create"
payload = {
"query": "<string>",
"name": "<string>",
"description": "<string>",
"status": "active",
"signal_types": [],
"signal_filters": [
{
"signal_type": "jobs",
"filters": { "locations": ["US"] }
},
{
"signal_type": "news",
"filters": { "locations": ["US"] }
},
{
"signal_type": "advertisements",
"filters": { "target_locations": ["US"] }
},
{
"signal_type": "expansions",
"filters": {
"tos": ["US"],
"stages": ["expanding", "scaling"],
"signal_types": ["HIRE", "EXEC"],
"signal_strengths": ["high", "very_high"]
}
}
],
"company_filters": {
"locations": ["US"],
"employees": [[501, 1000], [1001, 5000]]
},
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["<string>"],
"linkedin_urls": ["<string>"],
"is_company_enrichment": True,
"is_people_enrichment": True,
"people_enrichment_configs": [
{
"filters": { "people_locations": ["US"] },
"max_people_to_return": 3,
"people_contact_types": ["email-work"]
}
],
"destination_config": {
"webhook_url": "https://your-webhook.com/endpoint",
"headers": { "Authorization": "Bearer token" },
"body": { "pipeline": "my-webhook" }
},
"frequency_minute": 0,
"max_failure_trigger": 5,
"max_daily_trigger": 500,
"max_records_per_trigger": 25,
"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,
"max_daily_records": 200,
"notification_email": "[email protected]",
"max_retry_per_trigger": 1,
"retry_delay_second": 1,
"deep": 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({
query: '<string>',
name: '<string>',
description: '<string>',
status: 'active',
signal_types: [],
signal_filters: [
{signal_type: 'jobs', filters: {locations: ['US']}},
{signal_type: 'news', filters: {locations: ['US']}},
{signal_type: 'advertisements', filters: {target_locations: ['US']}},
{
signal_type: 'expansions',
filters: {
tos: ['US'],
stages: ['expanding', 'scaling'],
signal_types: ['HIRE', 'EXEC'],
signal_strengths: ['high', 'very_high']
}
}
],
company_filters: {locations: ['US'], employees: [[501, 1000], [1001, 5000]]},
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['<string>'],
linkedin_urls: ['<string>'],
is_company_enrichment: true,
is_people_enrichment: true,
people_enrichment_configs: [
{
filters: {people_locations: ['US']},
max_people_to_return: 3,
people_contact_types: ['email-work']
}
],
destination_config: {
webhook_url: 'https://your-webhook.com/endpoint',
headers: {Authorization: 'Bearer token'},
body: JSON.stringify({pipeline: 'my-webhook'})
},
frequency_minute: 0,
max_failure_trigger: 5,
max_daily_trigger: 500,
max_records_per_trigger: 25,
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,
max_daily_records: 200,
notification_email: '[email protected]',
max_retry_per_trigger: 1,
retry_delay_second: 1,
deep: true
})
};
fetch('https://api.pubrio.com/monitors/create', 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/create",
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([
'query' => '<string>',
'name' => '<string>',
'description' => '<string>',
'status' => 'active',
'signal_types' => [
],
'signal_filters' => [
[
'signal_type' => 'jobs',
'filters' => [
'locations' => [
'US'
]
]
],
[
'signal_type' => 'news',
'filters' => [
'locations' => [
'US'
]
]
],
[
'signal_type' => 'advertisements',
'filters' => [
'target_locations' => [
'US'
]
]
],
[
'signal_type' => 'expansions',
'filters' => [
'tos' => [
'US'
],
'stages' => [
'expanding',
'scaling'
],
'signal_types' => [
'HIRE',
'EXEC'
],
'signal_strengths' => [
'high',
'very_high'
]
]
]
],
'company_filters' => [
'locations' => [
'US'
],
'employees' => [
[
501,
1000
],
[
1001,
5000
]
]
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'<string>'
],
'linkedin_urls' => [
'<string>'
],
'is_company_enrichment' => true,
'is_people_enrichment' => true,
'people_enrichment_configs' => [
[
'filters' => [
'people_locations' => [
'US'
]
],
'max_people_to_return' => 3,
'people_contact_types' => [
'email-work'
]
]
],
'destination_config' => [
'webhook_url' => 'https://your-webhook.com/endpoint',
'headers' => [
'Authorization' => 'Bearer token'
],
'body' => [
'pipeline' => 'my-webhook'
]
],
'frequency_minute' => 0,
'max_failure_trigger' => 5,
'max_daily_trigger' => 500,
'max_records_per_trigger' => 25,
'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,
'max_daily_records' => 200,
'notification_email' => '[email protected]',
'max_retry_per_trigger' => 1,
'retry_delay_second' => 1,
'deep' => 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/create"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"status\": \"active\",\n \"signal_types\": [],\n \"signal_filters\": [\n {\n \"signal_type\": \"jobs\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"news\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"advertisements\",\n \"filters\": {\n \"target_locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"expansions\",\n \"filters\": {\n \"tos\": [\n \"US\"\n ],\n \"stages\": [\n \"expanding\",\n \"scaling\"\n ],\n \"signal_types\": [\n \"HIRE\",\n \"EXEC\"\n ],\n \"signal_strengths\": [\n \"high\",\n \"very_high\"\n ]\n }\n }\n ],\n \"company_filters\": {\n \"locations\": [\n \"US\"\n ],\n \"employees\": [\n [\n 501,\n 1000\n ],\n [\n 1001,\n 5000\n ]\n ]\n },\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 \"filters\": {\n \"people_locations\": [\n \"US\"\n ]\n },\n \"max_people_to_return\": 3,\n \"people_contact_types\": [\n \"email-work\"\n ]\n }\n ],\n \"destination_config\": {\n \"webhook_url\": \"https://your-webhook.com/endpoint\",\n \"headers\": {\n \"Authorization\": \"Bearer token\"\n },\n \"body\": {\n \"pipeline\": \"my-webhook\"\n }\n },\n \"frequency_minute\": 0,\n \"max_failure_trigger\": 5,\n \"max_daily_trigger\": 500,\n \"max_records_per_trigger\": 25,\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 \"max_daily_records\": 200,\n \"notification_email\": \"[email protected]\",\n \"max_retry_per_trigger\": 1,\n \"retry_delay_second\": 1,\n \"deep\": 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/create")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"status\": \"active\",\n \"signal_types\": [],\n \"signal_filters\": [\n {\n \"signal_type\": \"jobs\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"news\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"advertisements\",\n \"filters\": {\n \"target_locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"expansions\",\n \"filters\": {\n \"tos\": [\n \"US\"\n ],\n \"stages\": [\n \"expanding\",\n \"scaling\"\n ],\n \"signal_types\": [\n \"HIRE\",\n \"EXEC\"\n ],\n \"signal_strengths\": [\n \"high\",\n \"very_high\"\n ]\n }\n }\n ],\n \"company_filters\": {\n \"locations\": [\n \"US\"\n ],\n \"employees\": [\n [\n 501,\n 1000\n ],\n [\n 1001,\n 5000\n ]\n ]\n },\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 \"filters\": {\n \"people_locations\": [\n \"US\"\n ]\n },\n \"max_people_to_return\": 3,\n \"people_contact_types\": [\n \"email-work\"\n ]\n }\n ],\n \"destination_config\": {\n \"webhook_url\": \"https://your-webhook.com/endpoint\",\n \"headers\": {\n \"Authorization\": \"Bearer token\"\n },\n \"body\": {\n \"pipeline\": \"my-webhook\"\n }\n },\n \"frequency_minute\": 0,\n \"max_failure_trigger\": 5,\n \"max_daily_trigger\": 500,\n \"max_records_per_trigger\": 25,\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 \"max_daily_records\": 200,\n \"notification_email\": \"[email protected]\",\n \"max_retry_per_trigger\": 1,\n \"retry_delay_second\": 1,\n \"deep\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/monitors/create")
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 \"query\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"status\": \"active\",\n \"signal_types\": [],\n \"signal_filters\": [\n {\n \"signal_type\": \"jobs\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"news\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"advertisements\",\n \"filters\": {\n \"target_locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"expansions\",\n \"filters\": {\n \"tos\": [\n \"US\"\n ],\n \"stages\": [\n \"expanding\",\n \"scaling\"\n ],\n \"signal_types\": [\n \"HIRE\",\n \"EXEC\"\n ],\n \"signal_strengths\": [\n \"high\",\n \"very_high\"\n ]\n }\n }\n ],\n \"company_filters\": {\n \"locations\": [\n \"US\"\n ],\n \"employees\": [\n [\n 501,\n 1000\n ],\n [\n 1001,\n 5000\n ]\n ]\n },\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 \"filters\": {\n \"people_locations\": [\n \"US\"\n ]\n },\n \"max_people_to_return\": 3,\n \"people_contact_types\": [\n \"email-work\"\n ]\n }\n ],\n \"destination_config\": {\n \"webhook_url\": \"https://your-webhook.com/endpoint\",\n \"headers\": {\n \"Authorization\": \"Bearer token\"\n },\n \"body\": {\n \"pipeline\": \"my-webhook\"\n }\n },\n \"frequency_minute\": 0,\n \"max_failure_trigger\": 5,\n \"max_daily_trigger\": 500,\n \"max_records_per_trigger\": 25,\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 \"max_daily_records\": 200,\n \"notification_email\": \"[email protected]\",\n \"max_retry_per_trigger\": 1,\n \"retry_delay_second\": 1,\n \"deep\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"monitor_id": "c9cd5421-b327-4243-9cd7-8b341b3da8bd",
"name": "Expansion signals → JP",
"description": null,
"detection_mode": "signal_first",
"signal_types": [
"expansions"
],
"signal_filters": [
{
"signal_type": "expansions",
"filters": {
"tos": [
"JP"
]
}
}
],
"company_filters": {},
"company_count": 0,
"is_company_enrichment": false,
"is_people_enrichment": true,
"people_enrichment_configs": [
{
"max_people_to_return": 5,
"filters": {
"management_levels": [
"c_suite"
]
},
"people_contact_types": [
"email-work"
]
}
],
"destination_type": "email",
"destination_config": {
"emails": [
"[email protected]"
]
},
"frequency_minute": 5,
"notification_email": null,
"max_retry_per_trigger": 3,
"retry_delay_second": 60,
"max_records_per_trigger": 100,
"max_daily_trigger": 24,
"max_failure_trigger": 5,
"excluded_company_count": 0,
"record_unit": null,
"company_dedupe_days": 0,
"max_daily_records": 0,
"is_newest_first": false,
"status": "active",
"masked_signature": "5••••••••••••••8b8",
"created_at": "2026-07-16T10:27:40.469Z",
"signature": "52209a0d-f1c8-4111-a685-ac86edc678b8"
}
}{
"code": 40001,
"message": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
"details": {}
}{
"error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}{
"error": "Ocorreu um erro inesperado no servidor."
}Monitoramento
Criar Monitor
Cria um monitor de dados: uma vigilância sempre ativa que traz continuamente os sinais de negócio que importam para você — novas vagas de emprego, notícias, anúncios ou movimentos de expansão de mercado — a partir das empresas e filtros que você define, enriquece cada correspondência com dados de empresa e contato, e a entrega ao seu destino (e-mail ou webhook) na programação escolhida. Configure campo a campo, ou descreva todo o monitor em uma única frase em linguagem natural com query, que é interpretada na configuração dentro da mesma requisição.
POST
/
monitors
/
create
Criar um monitor
curl --request POST \
--url https://api.pubrio.com/monitors/create \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"query": "<string>",
"name": "<string>",
"description": "<string>",
"status": "active",
"signal_types": [],
"signal_filters": [
{
"signal_type": "jobs",
"filters": {
"locations": [
"US"
]
}
},
{
"signal_type": "news",
"filters": {
"locations": [
"US"
]
}
},
{
"signal_type": "advertisements",
"filters": {
"target_locations": [
"US"
]
}
},
{
"signal_type": "expansions",
"filters": {
"tos": [
"US"
],
"stages": [
"expanding",
"scaling"
],
"signal_types": [
"HIRE",
"EXEC"
],
"signal_strengths": [
"high",
"very_high"
]
}
}
],
"company_filters": {
"locations": [
"US"
],
"employees": [
[
501,
1000
],
[
1001,
5000
]
]
},
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"<string>"
],
"linkedin_urls": [
"<string>"
],
"is_company_enrichment": true,
"is_people_enrichment": true,
"people_enrichment_configs": [
{
"filters": {
"people_locations": [
"US"
]
},
"max_people_to_return": 3,
"people_contact_types": [
"email-work"
]
}
],
"destination_config": {
"webhook_url": "https://your-webhook.com/endpoint",
"headers": {
"Authorization": "Bearer token"
},
"body": {
"pipeline": "my-webhook"
}
},
"frequency_minute": 0,
"max_failure_trigger": 5,
"max_daily_trigger": 500,
"max_records_per_trigger": 25,
"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,
"max_daily_records": 200,
"notification_email": "[email protected]",
"max_retry_per_trigger": 1,
"retry_delay_second": 1,
"deep": true
}
'import requests
url = "https://api.pubrio.com/monitors/create"
payload = {
"query": "<string>",
"name": "<string>",
"description": "<string>",
"status": "active",
"signal_types": [],
"signal_filters": [
{
"signal_type": "jobs",
"filters": { "locations": ["US"] }
},
{
"signal_type": "news",
"filters": { "locations": ["US"] }
},
{
"signal_type": "advertisements",
"filters": { "target_locations": ["US"] }
},
{
"signal_type": "expansions",
"filters": {
"tos": ["US"],
"stages": ["expanding", "scaling"],
"signal_types": ["HIRE", "EXEC"],
"signal_strengths": ["high", "very_high"]
}
}
],
"company_filters": {
"locations": ["US"],
"employees": [[501, 1000], [1001, 5000]]
},
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["<string>"],
"linkedin_urls": ["<string>"],
"is_company_enrichment": True,
"is_people_enrichment": True,
"people_enrichment_configs": [
{
"filters": { "people_locations": ["US"] },
"max_people_to_return": 3,
"people_contact_types": ["email-work"]
}
],
"destination_config": {
"webhook_url": "https://your-webhook.com/endpoint",
"headers": { "Authorization": "Bearer token" },
"body": { "pipeline": "my-webhook" }
},
"frequency_minute": 0,
"max_failure_trigger": 5,
"max_daily_trigger": 500,
"max_records_per_trigger": 25,
"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,
"max_daily_records": 200,
"notification_email": "[email protected]",
"max_retry_per_trigger": 1,
"retry_delay_second": 1,
"deep": 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({
query: '<string>',
name: '<string>',
description: '<string>',
status: 'active',
signal_types: [],
signal_filters: [
{signal_type: 'jobs', filters: {locations: ['US']}},
{signal_type: 'news', filters: {locations: ['US']}},
{signal_type: 'advertisements', filters: {target_locations: ['US']}},
{
signal_type: 'expansions',
filters: {
tos: ['US'],
stages: ['expanding', 'scaling'],
signal_types: ['HIRE', 'EXEC'],
signal_strengths: ['high', 'very_high']
}
}
],
company_filters: {locations: ['US'], employees: [[501, 1000], [1001, 5000]]},
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['<string>'],
linkedin_urls: ['<string>'],
is_company_enrichment: true,
is_people_enrichment: true,
people_enrichment_configs: [
{
filters: {people_locations: ['US']},
max_people_to_return: 3,
people_contact_types: ['email-work']
}
],
destination_config: {
webhook_url: 'https://your-webhook.com/endpoint',
headers: {Authorization: 'Bearer token'},
body: JSON.stringify({pipeline: 'my-webhook'})
},
frequency_minute: 0,
max_failure_trigger: 5,
max_daily_trigger: 500,
max_records_per_trigger: 25,
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,
max_daily_records: 200,
notification_email: '[email protected]',
max_retry_per_trigger: 1,
retry_delay_second: 1,
deep: true
})
};
fetch('https://api.pubrio.com/monitors/create', 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/create",
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([
'query' => '<string>',
'name' => '<string>',
'description' => '<string>',
'status' => 'active',
'signal_types' => [
],
'signal_filters' => [
[
'signal_type' => 'jobs',
'filters' => [
'locations' => [
'US'
]
]
],
[
'signal_type' => 'news',
'filters' => [
'locations' => [
'US'
]
]
],
[
'signal_type' => 'advertisements',
'filters' => [
'target_locations' => [
'US'
]
]
],
[
'signal_type' => 'expansions',
'filters' => [
'tos' => [
'US'
],
'stages' => [
'expanding',
'scaling'
],
'signal_types' => [
'HIRE',
'EXEC'
],
'signal_strengths' => [
'high',
'very_high'
]
]
]
],
'company_filters' => [
'locations' => [
'US'
],
'employees' => [
[
501,
1000
],
[
1001,
5000
]
]
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'<string>'
],
'linkedin_urls' => [
'<string>'
],
'is_company_enrichment' => true,
'is_people_enrichment' => true,
'people_enrichment_configs' => [
[
'filters' => [
'people_locations' => [
'US'
]
],
'max_people_to_return' => 3,
'people_contact_types' => [
'email-work'
]
]
],
'destination_config' => [
'webhook_url' => 'https://your-webhook.com/endpoint',
'headers' => [
'Authorization' => 'Bearer token'
],
'body' => [
'pipeline' => 'my-webhook'
]
],
'frequency_minute' => 0,
'max_failure_trigger' => 5,
'max_daily_trigger' => 500,
'max_records_per_trigger' => 25,
'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,
'max_daily_records' => 200,
'notification_email' => '[email protected]',
'max_retry_per_trigger' => 1,
'retry_delay_second' => 1,
'deep' => 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/create"
payload := strings.NewReader("{\n \"query\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"status\": \"active\",\n \"signal_types\": [],\n \"signal_filters\": [\n {\n \"signal_type\": \"jobs\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"news\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"advertisements\",\n \"filters\": {\n \"target_locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"expansions\",\n \"filters\": {\n \"tos\": [\n \"US\"\n ],\n \"stages\": [\n \"expanding\",\n \"scaling\"\n ],\n \"signal_types\": [\n \"HIRE\",\n \"EXEC\"\n ],\n \"signal_strengths\": [\n \"high\",\n \"very_high\"\n ]\n }\n }\n ],\n \"company_filters\": {\n \"locations\": [\n \"US\"\n ],\n \"employees\": [\n [\n 501,\n 1000\n ],\n [\n 1001,\n 5000\n ]\n ]\n },\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 \"filters\": {\n \"people_locations\": [\n \"US\"\n ]\n },\n \"max_people_to_return\": 3,\n \"people_contact_types\": [\n \"email-work\"\n ]\n }\n ],\n \"destination_config\": {\n \"webhook_url\": \"https://your-webhook.com/endpoint\",\n \"headers\": {\n \"Authorization\": \"Bearer token\"\n },\n \"body\": {\n \"pipeline\": \"my-webhook\"\n }\n },\n \"frequency_minute\": 0,\n \"max_failure_trigger\": 5,\n \"max_daily_trigger\": 500,\n \"max_records_per_trigger\": 25,\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 \"max_daily_records\": 200,\n \"notification_email\": \"[email protected]\",\n \"max_retry_per_trigger\": 1,\n \"retry_delay_second\": 1,\n \"deep\": 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/create")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"query\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"status\": \"active\",\n \"signal_types\": [],\n \"signal_filters\": [\n {\n \"signal_type\": \"jobs\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"news\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"advertisements\",\n \"filters\": {\n \"target_locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"expansions\",\n \"filters\": {\n \"tos\": [\n \"US\"\n ],\n \"stages\": [\n \"expanding\",\n \"scaling\"\n ],\n \"signal_types\": [\n \"HIRE\",\n \"EXEC\"\n ],\n \"signal_strengths\": [\n \"high\",\n \"very_high\"\n ]\n }\n }\n ],\n \"company_filters\": {\n \"locations\": [\n \"US\"\n ],\n \"employees\": [\n [\n 501,\n 1000\n ],\n [\n 1001,\n 5000\n ]\n ]\n },\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 \"filters\": {\n \"people_locations\": [\n \"US\"\n ]\n },\n \"max_people_to_return\": 3,\n \"people_contact_types\": [\n \"email-work\"\n ]\n }\n ],\n \"destination_config\": {\n \"webhook_url\": \"https://your-webhook.com/endpoint\",\n \"headers\": {\n \"Authorization\": \"Bearer token\"\n },\n \"body\": {\n \"pipeline\": \"my-webhook\"\n }\n },\n \"frequency_minute\": 0,\n \"max_failure_trigger\": 5,\n \"max_daily_trigger\": 500,\n \"max_records_per_trigger\": 25,\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 \"max_daily_records\": 200,\n \"notification_email\": \"[email protected]\",\n \"max_retry_per_trigger\": 1,\n \"retry_delay_second\": 1,\n \"deep\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/monitors/create")
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 \"query\": \"<string>\",\n \"name\": \"<string>\",\n \"description\": \"<string>\",\n \"status\": \"active\",\n \"signal_types\": [],\n \"signal_filters\": [\n {\n \"signal_type\": \"jobs\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"news\",\n \"filters\": {\n \"locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"advertisements\",\n \"filters\": {\n \"target_locations\": [\n \"US\"\n ]\n }\n },\n {\n \"signal_type\": \"expansions\",\n \"filters\": {\n \"tos\": [\n \"US\"\n ],\n \"stages\": [\n \"expanding\",\n \"scaling\"\n ],\n \"signal_types\": [\n \"HIRE\",\n \"EXEC\"\n ],\n \"signal_strengths\": [\n \"high\",\n \"very_high\"\n ]\n }\n }\n ],\n \"company_filters\": {\n \"locations\": [\n \"US\"\n ],\n \"employees\": [\n [\n 501,\n 1000\n ],\n [\n 1001,\n 5000\n ]\n ]\n },\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 \"filters\": {\n \"people_locations\": [\n \"US\"\n ]\n },\n \"max_people_to_return\": 3,\n \"people_contact_types\": [\n \"email-work\"\n ]\n }\n ],\n \"destination_config\": {\n \"webhook_url\": \"https://your-webhook.com/endpoint\",\n \"headers\": {\n \"Authorization\": \"Bearer token\"\n },\n \"body\": {\n \"pipeline\": \"my-webhook\"\n }\n },\n \"frequency_minute\": 0,\n \"max_failure_trigger\": 5,\n \"max_daily_trigger\": 500,\n \"max_records_per_trigger\": 25,\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 \"max_daily_records\": 200,\n \"notification_email\": \"[email protected]\",\n \"max_retry_per_trigger\": 1,\n \"retry_delay_second\": 1,\n \"deep\": true\n}"
response = http.request(request)
puts response.read_body{
"data": {
"monitor_id": "c9cd5421-b327-4243-9cd7-8b341b3da8bd",
"name": "Expansion signals → JP",
"description": null,
"detection_mode": "signal_first",
"signal_types": [
"expansions"
],
"signal_filters": [
{
"signal_type": "expansions",
"filters": {
"tos": [
"JP"
]
}
}
],
"company_filters": {},
"company_count": 0,
"is_company_enrichment": false,
"is_people_enrichment": true,
"people_enrichment_configs": [
{
"max_people_to_return": 5,
"filters": {
"management_levels": [
"c_suite"
]
},
"people_contact_types": [
"email-work"
]
}
],
"destination_type": "email",
"destination_config": {
"emails": [
"[email protected]"
]
},
"frequency_minute": 5,
"notification_email": null,
"max_retry_per_trigger": 3,
"retry_delay_second": 60,
"max_records_per_trigger": 100,
"max_daily_trigger": 24,
"max_failure_trigger": 5,
"excluded_company_count": 0,
"record_unit": null,
"company_dedupe_days": 0,
"max_daily_records": 0,
"is_newest_first": false,
"status": "active",
"masked_signature": "5••••••••••••••8b8",
"created_at": "2026-07-16T10:27:40.469Z",
"signature": "52209a0d-f1c8-4111-a685-ac86edc678b8"
}
}{
"code": 40001,
"message": "Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações.",
"details": {}
}{
"error": "Limite de requisições excedido. Aguarde e tente novamente mais tarde."
}{
"error": "Ocorreu um erro inesperado no servidor."
}Autorizações
Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.
Corpo
application/json
- Natural language
- Structured fields
- Draft
Uma descrição em linguagem natural do monitor (em qualquer idioma), por exemplo "monitor companies expanding into Japan, get C-level people with their work email, and email alerts to [email protected] in real time". É interpretada nos campos abaixo (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute) na mesma requisição. Qualquer campo também passado explicitamente substitui o valor interpretado. Se o texto não for um pedido de monitor, a chamada retorna 400. Limitado a 2000 caracteres.
Maximum string length:
2000Nome do monitor.
Descrição do monitor.
Status do ciclo de vida com o qual criar o monitor. O padrão é active. Use draft para salvar um monitor incompleto: apenas name é obrigatório, a validação é adiada até a ativação, e um rascunho nunca é executado.
Opções disponíveis:
draft, active, paused, inactive Como os sinais são detectados. signal_first varre o mercado de forma ampla; company_first acompanha uma lista de contas nomeadas e exige ao menos uma empresa, domínio ou URL do LinkedIn. Imutável após a criação — alterá-lo em um monitor existente retorna 40021. Crie um novo monitor em vez disso.
Opções disponíveis:
company_first, signal_first Tipos de sinais a monitorar.
Opções disponíveis:
jobs, news, advertisements, expansions, cloud_footprints Uma entrada por fluxo de sinal que o monitor observa.
Show child attributes
Show child attributes
Exemplo:
[
{
"signal_type": "jobs",
"filters": { "locations": ["US"] }
},
{
"signal_type": "news",
"filters": { "locations": ["US"] }
},
{
"signal_type": "advertisements",
"filters": { "target_locations": ["US"] }
},
{
"signal_type": "expansions",
"filters": {
"tos": ["US"],
"stages": ["expanding", "scaling"],
"signal_types": ["HIRE", "EXEC"],
"signal_strengths": ["high", "very_high"]
}
}
]
Filtros globais de empresa aplicados como uma segunda camada em todos os tipos de sinal. Aceita os mesmos parâmetros do endpoint Company Search — localizações, número de funcionários, tecnologias, verticais e mais.
Exemplo:
{
"locations": ["US"],
"employees": [[501, 1000], [1001, 5000]]
}
Lista de UUIDs de domain_search_id de empresas a monitorar. Usado principalmente no modo company_first para especificar empresas-alvo. Você também pode usar domains ou linkedin_urls como alternativas — apenas um dos três é obrigatório.
Lista de domínios de empresas a monitorar (por exemplo, ["openai.com", "google.com"]). Alternativa a companies — a Pubrio resolve esses valores para as empresas correspondentes. Apenas um dos parâmetros companies, domains ou linkedin_urls é obrigatório.
Lista de URLs de empresas no LinkedIn a monitorar (por exemplo, ["https://linkedin.com/company/pubrio"]). Alternativa a companies — a Pubrio resolve esses valores para as empresas correspondentes. Apenas um dos parâmetros companies, domains ou linkedin_urls é obrigatório.
Se deve enriquecer dados de empresa nos resultados.
Se deve enriquecer dados de pessoas nos resultados.
Array de camadas de enriquecimento de pessoas. Cada camada executa uma busca de pessoas independente. Contém max_people_to_return (1-25), people_contact_types (array — refere-se aos tipos de contato de Redeem: email-work, email-personal, phone) e filters (mesmos parâmetros do endpoint People Search).
Exemplo:
[
{
"filters": { "people_locations": ["US"] },
"max_people_to_return": 3,
"people_contact_types": ["email-work"]
}
]
Tipo de destino de entrega.
Opções disponíveis:
webhook, email, sequences Configuração do destino. Para webhook: exige webhook_url (string), com headers (objeto) e body (objeto) opcionais. Para email: aceita email (string) ou emails (array de strings). Para sequences: exige sequence_identifier (string) mais ao menos um de is_people_search_enrolled / is_company_contact_enrolled definido como true.
Exemplo:
{
"webhook_url": "https://your-webhook.com/endpoint",
"headers": { "Authorization": "Bearer token" },
"body": { "pipeline": "my-webhook" }
}
Frequência de acionamento em minutos. Mín: 0, Máx: 10080, Padrão: 0.
Intervalo necessário:
0 <= x <= 10080Número máximo de falhas consecutivas antes de pausar o monitor. Mín: 1, Máx: 10, Padrão: 5.
Intervalo necessário:
1 <= x <= 10Número máximo de acionamentos por dia. Mín: 0, Máx: 86400, Padrão: 500.
Intervalo necessário:
0 <= x <= 86400Controla o número máximo de registros entregues por acionamento. Valores menores reduzem o tamanho do payload por entrega, o que é recomendado para conjuntos de resultados grandes ou integrações com limite de taxa. Mín: 1, Máx: 100, Padrão: 25. Veja Setting up Webhooks para orientações.
Intervalo necessário:
1 <= x <= 100Empresas que este monitor nunca entrega nem fatura, como UUIDs domain_search_id. Aplicado em ambos os modos de detecção em tempo de execução, antes do enriquecimento e da faturação; uma empresa presente em companies e nesta lista fica excluída enquanto permanecer na lista. Tamanho máximo: 100.000 (ids resolvidos entre excluded_companies, excluded_domains e excluded_linkedin_urls).
Exemplo:
["550e8400-e29b-41d4-a716-446655440002"]
Domínios de empresa a excluir (ex.: ["existing-client.com"]). Resolvidos para empresas e mesclados em excluded_companies.
Exemplo:
["existing-client.com"]
URLs de empresa do LinkedIn a excluir. Resolvidas para empresas e mescladas em excluded_companies.
Exemplo:
[
"https://linkedin.com/company/existing-client"
]
O que é um registro entregue: signal (payload signals[], uma entrada por sinal) ou company (payload companies[], uma entrada por empresa com seus sinais aninhados). O padrão segue detection_mode: signal_first → signal, company_first → company. Os limites (max_records_per_trigger, max_daily_records) contam esta unidade.
Opções disponíveis:
signal, company Exemplo:
"company"
Uma empresa aparece em no máximo uma entrega a cada tantos dias, em todos os tipos de sinal do monitor; uma empresa entregue dentro da janela fica fora das entregas seguintes e seus sinais seguintes dentro da janela são ignorados, não enfileirados. 0 = desligado. Padrão: 0.
Intervalo necessário:
x >= 0Exemplo:
30
Entregar primeiro os sinais correspondentes mais recentes. Com um limite por disparo ou diário, os registros mais novos são mantidos e o cursor do monitor avança mesmo assim até a linha mais nova buscada, então linhas antigas são ignoradas, nunca enfileiradas. Padrão false (mais antigos primeiro, nada ignorado).
Exemplo:
true
Limite rígido de registros entregues por dia civil no fuso do proprietário (0 = ilimitado). Contado na unidade de registro do monitor sobre entregas bem-sucedidas; um disparo entrega no máximo o orçamento restante e depois o monitor aguarda o dia seguinte sem mover seu cursor. Padrão: 0.
Intervalo necessário:
x >= 0Exemplo:
200
Endereço de e-mail para notificações de falha do monitor.
Número máximo de novas tentativas por acionamento. Mín: 0, Máx: 3, Padrão: 1.
Intervalo necessário:
0 <= x <= 3Intervalo entre novas tentativas, em segundos. Mín: 1, Máx: 5, Padrão: 1.
Intervalo necessário:
1 <= x <= 5Opcional, usado apenas com query. Executa a passagem de reflexão para maior precisão de interpretação (padrão true; aproximadamente dobra a latência de interpretação). Defina false para uma única passagem mais rápida.
Última modificação em 4 de setembro de 2026