> ## 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. # Пример: отслеживание вакансий > Полные пошаговые инструкции по отслеживанию вакансий с использованием режимов обнаружения company_first и signal_first — с кодом, готовым к копированию. Это руководство разбирает два реальных сценария. Каждый блок кода готов к копированию, вставке и запуску — просто замените `YOUR_API_KEY` на свой реальный ключ. ## Сценарий: узнавать, когда OpenAI публикует новые вакансии Вы хотите немедленно узнавать, когда OpenAI публикует открытые вакансии — и автоматически получать контактные данные их инженерного руководства. ### Создание монитора ```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); ``` **Что это делает:** * Отслеживает OpenAI (`companies: ["67c4696b-..."]`) на предмет новых вакансий в США * Обогащает данные о компании и находит до 5 контактов уровня Director/VP в инженерном направлении * Доставляет до 5 записей на триггер в ваш вебхук * Все остальные настройки используют разумные значения по умолчанию (частота в реальном времени, дневной лимит 500 и т.д.) Для режима `company_first` вам обычно нужны только `companies` (или `domains` / `linkedin_urls`) и фильтры сигналов. `company_filters` необязателен — он добавляет второй уровень фильтрации, когда вы хотите совместить список наблюдения с более широкими критериями по компаниям. ### Проверьте немедленно Не ждите планового сканирования — запустите ручной прогон, чтобы убедиться, что всё работает. Укажите `tried_at` с меткой времени в прошлом, чтобы гарантировать наличие данных (использование текущего времени может вернуть 0 результатов, если новые сигналы ещё не появились): ```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 }' ``` Ручные триггеры расходуют кредиты так же, как и запланированные. Используйте `tried_at` с недавней прошедшей датой, чтобы получить репрезентативную выборку результатов для тестирования. ### Проверка результатов Через несколько секунд проверьте свой URL вебхука на [usewebhook.com](https://usewebhook.com), чтобы увидеть payload. Вы также можете проверить через журналы: ```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 }' ``` Каждая запись журнала показывает статус, количество сигналов/компаний/людей, расход кредитов и время обработки. ## Сценарий: находим компании, активно нанимающие на роли в AI/ML Вы хотите находить компании, которые активно формируют команды по ИИ — независимо от того, отслеживали ли вы их раньше. Это сценарий использования для поиска потенциальных клиентов. ### Создание монитора ```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']}") ``` **Что это делает:** * Сканирует вакансии в области AI/ML по всей территории США * **Глобальные фильтры по компаниям** сужают результаты до компаний среднего размера (201-5 000 сотрудников) — в этом суть сочетания сигналов с критериями по компании * Обогащает данные о компаниях и находит до 3 контактов уровня founder/C-suite/VP * Добавляет пользовательское поле `pipeline` в payload'ы для маршрутизации в вашем обработчике вебхука * По умолчанию — частота в реальном времени ### Проверьте немедленно ```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 }' ``` Ручные триггеры расходуют кредиты. Используйте `tried_at` с недавней прошедшей датой, чтобы получить репрезентативные данные для тестирования — использование текущего времени может вернуть 0 результатов, если в этот момент не появилось новых сигналов. ### Что вы получаете Проверьте [usewebhook.com](https://usewebhook.com) — вы увидите payload `signal_first`, где сигналы являются основной структурой. Обратите внимание на пользовательское поле `pipeline` в корне, из вашего `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" } ``` *** ## Повтор неудавшейся доставки Если конкретный триггер завершился ошибкой (например, ваш вебхук был временно недоступен), повторите попытку без повторного запуска всего сканирования: ```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 }' ``` Найдите `monitor_log_id`, запросив [Statistic Logs](/ru/api-reference/endpoint/monitors/statistics_logs) и отфильтровав записи со `"status": "failed"`. *** ## Дальнейшие шаги Частота, кредиты, повторные попытки и масштабирование. Подробная настройка вебхука и проверка подписи.