> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Exemplo: Rastreando Vagas de Emprego
> Passo a passo completo para monitorar vagas de emprego usando os modos de detecção company_first e signal_first — com código pronto para copiar.
Este guia percorre dois cenários do mundo real. Cada bloco de código está pronto para copiar, colar e executar — basta substituir `YOUR_API_KEY` pela sua chave real.
## Cenário: Monitorar quando a OpenAI publica novas vagas
Você quer saber imediatamente quando a OpenAI publica vagas — e obter automaticamente os dados de contato da liderança de engenharia.
### Criar o monitor
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/monitors/create \
-H "Content-Type: application/json" \
-H "pubrio-api-key: YOUR_API_KEY" \
-d '{
"name": "OpenAI Job Tracker",
"detection_mode": "company_first",
"signal_types": ["jobs"],
"signal_filters": [
{
"signal_type": "jobs",
"filters": {
"locations": ["US"]
}
}
],
"companies": [
"67c4696b-b7b0-46b5-b2af-9f434543661e"
],
"is_company_enrichment": true,
"is_people_enrichment": true,
"people_enrichment_configs": [
{
"max_people_to_return": 5,
"people_contact_types": ["email-work"],
"filters": {
"management_levels": ["director", "vp"],
"departments": ["master_engineering"]
}
}
],
"destination_type": "webhook",
"destination_config": {
"webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
"headers": {
"Authorization": "Bearer your-secret-token"
}
},
"max_records_per_trigger": 5,
"profile_id": 1
}'
```
```python Python theme={null}
import requests
response = requests.post(
"https://api.pubrio.com/monitors/create",
headers={
"Content-Type": "application/json",
"pubrio-api-key": "YOUR_API_KEY"
},
json={
"name": "OpenAI Job Tracker",
"detection_mode": "company_first",
"signal_types": ["jobs"],
"signal_filters": [
{
"signal_type": "jobs",
"filters": {
"locations": ["US"]
}
}
],
"companies": [
"67c4696b-b7b0-46b5-b2af-9f434543661e"
],
"is_company_enrichment": True,
"is_people_enrichment": True,
"people_enrichment_configs": [
{
"max_people_to_return": 5,
"people_contact_types": ["email-work"],
"filters": {
"management_levels": ["director", "vp"],
"departments": ["master_engineering"]
}
}
],
"destination_type": "webhook",
"destination_config": {
"webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
"headers": {
"Authorization": "Bearer your-secret-token"
}
},
"max_records_per_trigger": 5,
"profile_id": 1
}
)
data = response.json()
print(f"Monitor created: {data['data']['monitor_id']}")
print(f"Signature: {data['data']['signature']}")
```
```javascript Node.js theme={null}
const response = await fetch("https://api.pubrio.com/monitors/create", {
method: "POST",
headers: {
"Content-Type": "application/json",
"pubrio-api-key": "YOUR_API_KEY"
},
body: JSON.stringify({
name: "OpenAI Job Tracker",
detection_mode: "company_first",
signal_types: ["jobs"],
signal_filters: [
{
signal_type: "jobs",
filters: {
locations: ["US"]
}
}
],
companies: [
"67c4696b-b7b0-46b5-b2af-9f434543661e"
],
is_company_enrichment: true,
is_people_enrichment: true,
people_enrichment_configs: [
{
max_people_to_return: 5,
people_contact_types: ["email-work"],
filters: {
management_levels: ["director", "vp"],
departments: ["master_engineering"]
}
}
],
destination_type: "webhook",
destination_config: {
webhook_url: "https://usewebhook.com/YOUR_WEBHOOK_ID",
headers: {
Authorization: "Bearer your-secret-token"
}
},
max_records_per_trigger: 5,
profile_id: 1
})
});
const data = await response.json();
console.log("Monitor created:", data.data.monitor_id);
console.log("Signature:", data.data.signature);
```
**O que isso faz:**
* Monitora a OpenAI (`companies: ["67c4696b-..."]`) em busca de novas vagas nos EUA
* Enriquece os dados da empresa e encontra até 5 contatos de Diretor/VP em Engenharia
* Entrega até 5 registros por acionamento ao seu webhook
* Todas as demais configurações usam os padrões (frequência em tempo real, limite diário de 500, etc.)
No modo `company_first`, normalmente você só precisa de `companies` (ou `domains` / `linkedin_urls`) e dos filtros de sinal. `company_filters` é opcional — adiciona uma segunda camada de filtragem quando você quer combinar uma lista de observação com critérios mais amplos de empresa.
### Testar imediatamente
Não espere pela varredura agendada — acione uma execução manual para verificar se tudo funciona. Inclua `tried_at` com um timestamp no passado para garantir que haja dados disponíveis (usar o horário atual pode retornar 0 resultados se nenhum sinal novo tiver aparecido ainda):
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/monitors/process/try \
-H "Content-Type: application/json" \
-H "pubrio-api-key: YOUR_API_KEY" \
-d '{
"monitor_id": "YOUR_MONITOR_ID",
"tried_at": "2026-01-01T00:00:00.000Z",
"profile_id": 1
}'
```
Acionamentos manuais consomem créditos da mesma forma que os acionamentos agendados. Use `tried_at` com uma data recente no passado para obter uma amostra representativa de resultados para teste.
### Verificar os resultados
Depois de alguns segundos, verifique a sua URL de webhook no [usewebhook.com](https://usewebhook.com) para ver o payload. Você também pode verificar pelos logs:
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/monitors/statistics/logs \
-H "Content-Type: application/json" \
-H "pubrio-api-key: YOUR_API_KEY" \
-d '{
"profile_id": 1,
"monitor_id": "YOUR_MONITOR_ID",
"page": 1,
"per_page": 5
}'
```
Cada entrada de log mostra o status, as contagens de sinais/empresas/pessoas, o consumo de créditos e o tempo de processamento.
## Cenário: Descobrir empresas contratando para funções de IA/ML
Você quer encontrar empresas construindo ativamente equipes de IA — independentemente de já ter acompanhado essas empresas antes. Este é um caso de uso de prospecção.
### Criar o monitor
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/monitors/create \
-H "Content-Type: application/json" \
-H "pubrio-api-key: YOUR_API_KEY" \
-d '{
"name": "AI Hiring Discovery",
"detection_mode": "signal_first",
"signal_types": ["jobs"],
"signal_filters": [
{
"signal_type": "jobs",
"filters": {
"titles": ["Machine Learning", "AI Engineer", "Data Scientist"],
"locations": ["US"]
}
}
],
"company_filters": {
"employees": [[201, 500], [501, 1000], [1001, 5000]]
},
"is_company_enrichment": true,
"is_people_enrichment": true,
"people_enrichment_configs": [
{
"max_people_to_return": 3,
"people_contact_types": ["email-work"],
"filters": {
"management_levels": ["founder", "c_suite", "vp"]
}
}
],
"destination_type": "webhook",
"destination_config": {
"webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
"body": {
"pipeline": "ai-prospecting"
}
},
"max_records_per_trigger": 10,
"profile_id": 1
}'
```
```python Python theme={null}
import requests
response = requests.post(
"https://api.pubrio.com/monitors/create",
headers={
"Content-Type": "application/json",
"pubrio-api-key": "YOUR_API_KEY"
},
json={
"name": "AI Hiring Discovery",
"detection_mode": "signal_first",
"signal_types": ["jobs"],
"signal_filters": [
{
"signal_type": "jobs",
"filters": {
"titles": ["Machine Learning", "AI Engineer", "Data Scientist"],
"locations": ["US"]
}
}
],
"company_filters": {
"employees": [[201, 500], [501, 1000], [1001, 5000]]
},
"is_company_enrichment": True,
"is_people_enrichment": True,
"people_enrichment_configs": [
{
"max_people_to_return": 3,
"people_contact_types": ["email-work"],
"filters": {
"management_levels": ["founder", "c_suite", "vp"]
}
}
],
"destination_type": "webhook",
"destination_config": {
"webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
"body": {
"pipeline": "ai-prospecting"
}
},
"max_records_per_trigger": 10,
"profile_id": 1
}
)
data = response.json()
print(f"Monitor created: {data['data']['monitor_id']}")
```
**O que isso faz:**
* Busca por vagas de IA/ML publicadas nos EUA
* **Filtros globais de empresa** restringem os resultados a empresas de médio porte (201 a 5.000 funcionários) — esse é o poder de combinar sinais com critérios de empresa
* Enriquece as empresas e encontra até 3 contatos de fundador/C-level/VP
* Adiciona um campo `pipeline` personalizado aos payloads para roteamento no seu handler de webhook
* Frequência em tempo real por padrão
### Testar imediatamente
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/monitors/process/try \
-H "Content-Type: application/json" \
-H "pubrio-api-key: YOUR_API_KEY" \
-d '{
"monitor_id": "YOUR_MONITOR_ID",
"tried_at": "2026-01-01T00:00:00.000Z",
"profile_id": 1
}'
```
Acionamentos manuais consomem créditos. Use `tried_at` com uma data recente no passado para obter dados representativos para teste — usar o horário atual pode retornar 0 resultados se nenhum sinal novo tiver aparecido naquele instante.
### O que você recebe
Verifique o [usewebhook.com](https://usewebhook.com) — você verá um payload `signal_first` com os sinais como estrutura principal. Observe o campo `pipeline` personalizado na raiz, vindo do seu `destination_config.body`:
```json theme={null}
{
"monitor": { ... },
"metadata": {
"total_signals": 5,
"total_companies": 4,
"total_people": 10
},
"triggered_at": "2026-04-06T14:30:00.000Z",
"signals": [
{
"signal_type": "jobs",
"signal": { ... },
"companies": [
{
"company_name": "...",
"domain": "...",
"company_size": 800,
"people": [...],
...
}
]
},
...
],
"pipeline": "ai-prospecting"
}
```
***
## Repetindo uma Entrega Malsucedida
Se um acionamento específico falhou (por exemplo, seu webhook estava temporariamente indisponível), você pode repeti-lo sem executar toda a varredura novamente:
```bash cURL theme={null}
curl -X POST https://api.pubrio.com/monitors/process/retry \
-H "Content-Type: application/json" \
-H "pubrio-api-key: YOUR_API_KEY" \
-d '{
"monitor_id": "YOUR_MONITOR_ID",
"monitor_log_id": "THE_FAILED_LOG_ID",
"profile_id": 1
}'
```
Encontre o `monitor_log_id` consultando os [Statistic Logs](/pt/api-reference/endpoint/monitors/statistics_logs) e filtrando as entradas com `"status": "failed"`.
***
## Próximos Passos
Frequência, créditos, novas tentativas e escalabilidade.
Configuração detalhada de webhooks e verificação de assinatura.