Ejemplo: rastrear publicaciones de empleo

Esta guía recorre dos escenarios del mundo real. Cada bloque de código está listo para copiar, pegar y ejecutar — solo reemplaza YOUR_API_KEY con tu clave real.

Company First: rastrear OpenAI
Signal First: descubrir contratación de IA

Escenario: monitorear cuándo OpenAI publica nuevos empleos

Quieres saber de inmediato cuándo OpenAI publica vacantes — y obtener automáticamente los datos de contacto de su liderazgo de ingeniería.

Crear el monitor

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
  }'

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']}")

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);

Qué hace esto:

Monitorea a OpenAI (companies: ["67c4696b-..."]) en busca de nuevas publicaciones de empleo con sede en EE. UU.
Enriquece los datos de la empresa y encuentra hasta 5 contactos de Ingeniería a nivel Director/VP
Entrega hasta 5 registros por trigger a tu webhook
El resto de la configuración usa valores por defecto razonables (frecuencia en tiempo real, tope diario de 500, etc.)

Para el modo company_first, normalmente solo necesitas companies (o domains / linkedin_urls) y los filtros de señal. company_filters es opcional — agrega una segunda capa de filtrado cuando quieres combinar una lista de vigilancia con criterios de empresa más amplios.

Pruébalo de inmediato

No esperes al escaneo programado — dispara una ejecución manual para verificar que todo funciona. Incluye tried_at con una marca de tiempo pasada para asegurarte de que haya datos disponibles (usar la hora actual puede devolver 0 resultados si aún no han aparecido señales nuevas):

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
  }'

Los triggers manuales consumen créditos igual que los triggers programados. Usa tried_at con una fecha pasada reciente para obtener una muestra representativa de resultados para pruebas.

Revisa los resultados

Después de unos segundos, revisa tu URL de webhook en usewebhook.com para ver el payload. También puedes verificarlo mediante los logs:

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 muestra el estado, los conteos de señales/empresas/personas, el uso de créditos y el tiempo de procesamiento.

Escenario: descubrir empresas contratando para roles de IA/ML

Quieres encontrar empresas que están construyendo activamente equipos de IA — independientemente de si las has rastreado antes. Este es un caso de uso de prospección.

Crear el monitor

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
  }'

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']}")

Qué hace esto:

Escanea publicaciones de empleo de IA/ML en todo EE. UU.
Los filtros globales de empresa acotan los resultados a empresas medianas (201-5.000 empleados) — este es el poder de combinar señales con criterios de empresa
Enriquece las empresas y encuentra hasta 3 contactos de fundador/C-suite/VP
Agrega un campo pipeline personalizado a los payloads para el enrutamiento en tu manejador de webhook
Frecuencia en tiempo real por defecto

Pruébalo de inmediato

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
  }'

Los triggers manuales consumen créditos. Usa tried_at con una fecha pasada reciente para obtener datos representativos para pruebas — usar la hora actual puede devolver 0 resultados si no han aparecido señales nuevas en ese instante.

Qué recibes

Revisa usewebhook.com — verás un payload signal_first con las señales como estructura principal. Observa el campo personalizado pipeline en la raíz, proveniente de tu destination_config.body:

{
  "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"
}

Reintentar una entrega fallida

Si un trigger específico falló (por ejemplo, tu webhook estuvo temporalmente caído), reinténtalo sin volver a ejecutar todo el escaneo:

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
  }'

Encuentra el monitor_log_id consultando Statistic Logs y filtrando las entradas con "status": "failed".

Monitor

Búsqueda

Filtros

Personas

Expansión

Ejemplo: rastrear publicaciones de empleo

Escenario: monitorear cuándo OpenAI publica nuevos empleos

Crear el monitor

Pruébalo de inmediato

Revisa los resultados

Escenario: descubrir empresas contratando para roles de IA/ML

Crear el monitor

Pruébalo de inmediato

Qué recibes

Reintentar una entrega fallida

Próximos pasos

Buenas prácticas

Configuración de webhook

​Escenario: monitorear cuándo OpenAI publica nuevos empleos

​Crear el monitor

​Pruébalo de inmediato

​Revisa los resultados

​Escenario: descubrir empresas contratando para roles de IA/ML

​Crear el monitor

​Pruébalo de inmediato

​Qué recibes

​Reintentar una entrega fallida

​Próximos pasos

Buenas prácticas

Configuración de webhook

Escenario: monitorear cuándo OpenAI publica nuevos empleos

Crear el monitor

Pruébalo de inmediato

Revisa los resultados

Escenario: descubrir empresas contratando para roles de IA/ML

Crear el monitor

Pruébalo de inmediato

Qué recibes

Reintentar una entrega fallida

Próximos pasos