Exemple : suivi des offres d'emploi

Ce guide présente deux scénarios concrets. Chaque bloc de code est prêt à être copié, collé et exécuté — remplacez simplement YOUR_API_KEY par votre clé réelle.

Company First : suivre OpenAI
Signal First : découvrir le recrutement IA

Scénario : être informé lorsqu’OpenAI publie de nouvelles offres

Vous souhaitez être informé immédiatement lorsqu’OpenAI publie des offres d’emploi — et obtenir automatiquement les coordonnées de ses responsables techniques.

Créer le moniteur

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

Ce que cela fait :

Surveille OpenAI (companies: ["67c4696b-..."]) pour détecter de nouvelles offres d’emploi basées aux États-Unis
Enrichit les données d’entreprise et trouve jusqu’à 5 contacts de niveau Directeur/VP en Ingénierie
Livre jusqu’à 5 enregistrements par déclenchement à votre webhook
Tous les autres paramètres utilisent des valeurs par défaut raisonnables (fréquence en temps réel, plafond quotidien de 500, etc.)

Pour le mode company_first, vous n’avez généralement besoin que de companies (ou domains / linkedin_urls) et des filtres de signal. company_filters est facultatif — il ajoute une seconde couche de filtrage lorsque vous souhaitez combiner une liste de surveillance avec des critères d’entreprise plus larges.

Le tester immédiatement

N’attendez pas l’analyse planifiée — déclenchez une exécution manuelle pour vérifier que tout fonctionne. Incluez tried_at avec un horodatage passé pour garantir la disponibilité de données (utiliser l’heure actuelle peut renvoyer 0 résultat si aucun nouveau signal n’est encore apparu) :

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

Les déclenchements manuels consomment des crédits, tout comme les déclenchements planifiés. Utilisez tried_at avec une date passée récente pour obtenir un échantillon représentatif de résultats à des fins de test.

Vérifier les résultats

Après quelques secondes, consultez votre URL de webhook sur usewebhook.com pour voir la charge utile. Vous pouvez également vérifier via les journaux :

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

Chaque entrée de journal affiche le statut, le nombre de signaux/entreprises/personnes, l’utilisation des crédits et le temps de traitement.

Scénario : découvrir les entreprises qui recrutent pour des postes IA/ML

Vous souhaitez trouver les entreprises qui constituent activement des équipes IA — que vous les ayez déjà suivies ou non. Il s’agit d’un cas d’usage de prospection.

Créer le moniteur

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

Ce que cela fait :

Recherche les offres d’emploi IA/ML à travers les États-Unis
Les filtres d’entreprise globaux restreignent les résultats aux entreprises de taille moyenne (201 à 5 000 employés) — c’est là toute la puissance de la combinaison des signaux avec des critères d’entreprise
Enrichit les entreprises et trouve jusqu’à 3 contacts fondateur/direction générale/VP
Ajoute un champ personnalisé pipeline aux charges utiles pour le routage dans votre gestionnaire de webhook
Fréquence en temps réel par défaut

Le tester immédiatement

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

Les déclenchements manuels consomment des crédits. Utilisez tried_at avec une date passée récente pour obtenir des données représentatives à des fins de test — utiliser l’heure actuelle peut renvoyer 0 résultat si aucun nouveau signal n’est apparu à cet instant précis.

Ce que vous recevez

Consultez usewebhook.com — vous verrez une charge utile signal_first avec les signaux comme structure principale. Notez le champ personnalisé pipeline à la racine, provenant de votre 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"
}

Réessayer une livraison échouée

Si un déclenchement spécifique a échoué (par exemple, votre webhook était temporairement indisponible), réessayez-le sans relancer l’intégralité de l’analyse :

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

Trouvez le monitor_log_id en interrogeant Statistic Logs et en filtrant les entrées portant "status": "failed".

Monitor

Recherche

Filtres

Personnes

Expansion

Exemple : suivi des offres d'emploi

Scénario : être informé lorsqu’OpenAI publie de nouvelles offres

Créer le moniteur

Le tester immédiatement

Vérifier les résultats

Scénario : découvrir les entreprises qui recrutent pour des postes IA/ML

Créer le moniteur

Le tester immédiatement

Ce que vous recevez

Réessayer une livraison échouée

Étapes suivantes

Bonnes pratiques

Configuration des webhooks

​Scénario : être informé lorsqu’OpenAI publie de nouvelles offres

​Créer le moniteur

​Le tester immédiatement

​Vérifier les résultats

​Scénario : découvrir les entreprises qui recrutent pour des postes IA/ML

​Créer le moniteur

​Le tester immédiatement

​Ce que vous recevez

​Réessayer une livraison échouée

​Étapes suivantes

Bonnes pratiques

Configuration des webhooks

Scénario : être informé lorsqu’OpenAI publie de nouvelles offres

Créer le moniteur

Le tester immédiatement

Vérifier les résultats

Scénario : découvrir les entreprises qui recrutent pour des postes IA/ML

Créer le moniteur

Le tester immédiatement

Ce que vous recevez

Réessayer une livraison échouée

Étapes suivantes