> ## 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. # Monitor erstellen > Erstellt einen Daten-Monitor: eine ständig aktive Überwachung, die kontinuierlich die für Sie relevanten Geschäftssignale aufdeckt — neue Stellenausschreibungen, News, Werbeanzeigen oder Marktexpansionsbewegungen — aus den von Ihnen definierten Unternehmen und Filtern, jeden Treffer mit Unternehmens- und Kontaktdaten anreichert und ihn nach Ihrem gewählten Zeitplan an Ihr Ziel (E-Mail oder Webhook) zustellt. Konfigurieren Sie ihn Feld für Feld, oder beschreiben Sie den gesamten Monitor in einem einzigen Satz in natürlicher Sprache mit `query`, der dann innerhalb derselben Anfrage in die Konfiguration interpretiert wird. ## OpenAPI ````yaml de-openapi POST /monitors/create openapi: 3.0.0 info: description: >- Die Pubrio API liefert Market-Expansion-Intelligence – Echtzeit-Signale, die anzeigen, wenn ein Unternehmen in einen neuen Markt eintritt – zusammen mit den zugrunde liegenden Unternehmens- und Personendaten. Durchsuchen, schlagen Sie nach und reichern Sie Accounts und Kontakte an, und abonnieren Sie typisierte, datierte Bewegungssignale in über 200 Märkten. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/de/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/de/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Workspace-Profilinformationen und Nutzungsstatistiken - name: Enrichment description: >- Personen- und Unternehmensdatensätze mit detaillierten B2B-Daten anreichern - name: Lookalike description: Unternehmen finden, die einem bestimmten Unternehmen ähnlich sind - name: Search description: >- Personen, Unternehmen, Stellenanzeigen, Nachrichten und Werbeanzeigen mit Filtern durchsuchen - name: Lookup description: >- Detaillierte Informationen zu bestimmten Personen, Unternehmen, Stellenanzeigen, Nachrichten, Werbeanzeigen und Technologien nachschlagen - name: LinkedIn description: Personen- und Unternehmensdaten über LinkedIn-Profil-URLs nachschlagen - name: Redeem description: >- Credits einlösen, um Kontaktdaten von Personen freizuschalten (einzeln und im Batch) - name: Channels description: >- Outreach-Kanalvorlagen verwalten (erstellen, aktualisieren, löschen, auflisten) - name: Monitor description: >- Daten-Monitore mit Webhooks, Statistiken und Verarbeitung erstellen und verwalten - name: Filters description: >- Verfügbare Filterwerte für Suchparameter abrufen (Technologien, Standorte, Branchen usw.) - name: API Keys description: >- API-Anfrageprotokolle und Nutzungsanalysen für API-Schlüssel auflisten und einsehen - name: Insights description: >- Aggregierte Signal-Insights für Unternehmen (Stellenanzeigen, Nachrichten, Werbeanzeigen). - name: Export description: Massendatenexporte (kreditpflichtig). - name: Expansion description: >- Market-Expansion-Intelligence für Unternehmen: Signale, Phasen, Märkte und Exporte. externalDocs: description: >- Die Pubrio-API dient zum Suchen, Anzeigen einer Vorschau und Anreichern von Kontakten und Accounts. Die Pubrio-Datenbank bietet umfangreiche B2B-Kontakt- und Sales-Intelligence-Daten. url: https://docs.pubrio.com paths: /monitors/create: post: tags: - Monitor summary: Monitor erstellen description: >- Erstellt einen Daten-Monitor: eine ständig aktive Überwachung, die kontinuierlich die für Sie relevanten Geschäftssignale aufdeckt — neue Stellenausschreibungen, News, Werbeanzeigen oder Marktexpansionsbewegungen — aus den von Ihnen definierten Unternehmen und Filtern, jeden Treffer mit Unternehmens- und Kontaktdaten anreichert und ihn nach Ihrem gewählten Zeitplan an Ihr Ziel (E-Mail oder Webhook) zustellt. Konfigurieren Sie ihn Feld für Feld, oder beschreiben Sie den gesamten Monitor in einem einzigen Satz in natürlicher Sprache mit `query`, der dann innerhalb derselben Anfrage in die Konfiguration interpretiert wird. operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: Name des Monitors. description: type: string description: Beschreibung des Monitors. status: type: string description: >- Lebenszyklusstatus, mit dem der Monitor erstellt werden soll. Standardmäßig `active`. Verwenden Sie `draft`, um einen halb fertigen Monitor zu speichern: Nur `name` ist erforderlich, die Validierung wird bis zur Aktivierung verschoben, und ein Entwurf wird nie ausgeführt. enum: - draft - active - paused - inactive default: active detection_mode: type: string description: >- Wie Signale erkannt werden. `signal_first` durchsucht den Markt breit; `company_first` verfolgt eine benannte Kontenliste und erfordert mindestens ein Unternehmen, eine Domain oder eine LinkedIn-URL. **Nach der Erstellung unveränderlich** — das Ändern bei einem bestehenden Monitor gibt `40021` zurück. Erstellen Sie stattdessen einen neuen Monitor. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions description: Zu überwachende Signaltypen. signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions description: Welchen Stream dieser Eintrag filtert. filters: type: object description: >- Filter für diesen Stream. `jobs`, `news` und `advertisements` verwenden die Parameter von [Job-Suche](/de/api-reference/endpoint/companies/job_search), [News-Suche](/de/api-reference/endpoint/companies/news_search) und [Anzeigen-Suche](/de/api-reference/endpoint/companies/advertisements_search). `expansions` verwendet das Vokabular der [Expansion-Suche](/de/api-reference/endpoint/expansions/market_lookup): `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Slugs können über die [Expansion-Referenz](/de/api-reference/endpoint/expansions/types) aufgelöst werden. description: Ein Eintrag pro Signal-Stream, den der Monitor überwacht. example: - 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: type: object description: >- Globale Unternehmensfilter, die als zweite Ebene über alle Signaltypen hinweg angewendet werden. Akzeptiert dieselben Parameter wie der [Unternehmenssuche](/de/api-reference/endpoint/companies/search)-Endpunkt — Standorte, Mitarbeiterzahl, Technologien, Branchen und mehr. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- Liste von zu überwachenden domain_search_id-UUIDs von Unternehmen. Wird hauptsächlich im company_first-Modus verwendet, um Zielunternehmen anzugeben. Sie können alternativ auch `domains` oder `linkedin_urls` verwenden — nur eines der drei ist erforderlich. domains: type: array items: type: string description: >- Liste der zu überwachenden Unternehmensdomains (z. B. ["openai.com", "google.com"]). Alternative zu `companies` — Pubrio löst diese zu den entsprechenden Unternehmen auf. Nur eines von `companies`, `domains` oder `linkedin_urls` ist erforderlich. linkedin_urls: type: array items: type: string format: uri description: >- Liste der zu überwachenden LinkedIn-Unternehmens-URLs (z. B. ["https://linkedin.com/company/pubrio"]). Alternative zu `companies` — Pubrio löst diese zu den entsprechenden Unternehmen auf. Nur eines von `companies`, `domains` oder `linkedin_urls` ist erforderlich. is_company_enrichment: type: boolean description: >- Ob Unternehmensdaten in den Ergebnissen angereichert werden sollen. is_people_enrichment: type: boolean description: >- Ob Personendaten in den Ergebnissen angereichert werden sollen. people_enrichment_configs: type: array items: type: object description: >- Array von Personenanreicherungs-Ebenen. Jede Ebene führt eine unabhängige Personensuche aus. Enthält `max_people_to_return` (1-25), `people_contact_types` (Array — bezieht sich auf [Redeem](/de/api-reference/endpoint/redeem/people)-Kontakttypen: email-work, email-personal, phone) und `filters` (dieselben Parameter wie der [Personensuche](/de/api-reference/endpoint/people/search)-Endpunkt). example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: Typ des Zustellziels. enum: - webhook - email - sequences destination_config: type: object description: >- Konfiguration des Ziels. Für Webhook: erfordert `webhook_url` (String), optional `headers` (Objekt) und `body` (Objekt). Für E-Mail: akzeptiert `email` (String) oder `emails` (Array von Strings). Für Sequenzen: erfordert `sequence_identifier` (String) plus mindestens eines von `is_people_search_enrolled` / `is_company_contact_enrolled` auf true gesetzt. example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: 'Auslösefrequenz in Minuten. Min: 0, Max: 10080, Standard: 0.' minimum: 0 maximum: 10080 default: 0 max_failure_trigger: type: integer description: >- Maximale Anzahl aufeinanderfolgender Fehlschläge, bevor der Monitor pausiert wird. Min: 1, Max: 10, Standard: 5. minimum: 1 maximum: 10 default: 5 max_daily_trigger: type: integer description: >- Maximale Anzahl von Auslösungen pro Tag. Min: 0, Max: 86400, Standard: 500. minimum: 0 maximum: 86400 default: 500 max_records_per_trigger: type: integer description: >- Steuert die maximale Anzahl der pro Auslösung zugestellten Datensätze. Niedrigere Werte verringern die Payload-Größe pro Zustellung, was für große Ergebnismengen oder ratenbegrenzte Integrationen empfohlen wird. Min: 1, Max: 100, Standard: 25. Weitere Hinweise finden Sie unter [Webhooks einrichten](/de/developer-guides/setting-up-webhooks). minimum: 1 maximum: 100 default: 25 notification_email: type: string format: email description: E-Mail-Adresse für Fehlerbenachrichtigungen des Monitors. max_retry_per_trigger: type: integer description: >- Maximale Wiederholungen pro Auslösung. Min: 0, Max: 3, Standard: 1. minimum: 0 maximum: 3 default: 1 retry_delay_second: type: integer description: >- Verzögerung zwischen Wiederholungen in Sekunden. Min: 1, Max: 5, Standard: 1. minimum: 1 maximum: 5 default: 1 query: type: string maxLength: 2000 description: >- Eine Beschreibung des Monitors in natürlicher Sprache (beliebige Sprache), z. B. "monitor companies expanding into Japan, get C-level people with their work email, and email alerts to me@company.com in real time". Sie wird innerhalb derselben Anfrage in die untenstehenden Felder interpretiert (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute). Jedes Feld, das Sie zusätzlich explizit angeben, überschreibt den interpretierten Wert. Wenn der Text keine Monitor-Anfrage ist, gibt der Aufruf 400 zurück. Auf 2000 Zeichen begrenzt. deep: type: boolean description: >- Optional, wird nur mit `query` verwendet. Führt den Reflection-Durchlauf für höhere Interpretationsgenauigkeit aus (Standard true; verdoppelt in etwa die Interpretationslatenz). Auf false setzen für einen schnelleren Einzeldurchlauf. anyOf: - title: Natural language required: - query - title: Structured fields required: - name - detection_mode - signal_types - destination_type - destination_config - title: Draft required: - name - status responses: '200': description: Erfolgreiche Antwort mit den Details des neu erstellten Monitors. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: Eindeutige Kennung des neu erstellten Monitors. name: type: string description: Name des Monitors. description: type: string description: Beschreibung des Monitors. detection_mode: type: string description: 'Erkennungsmodus: ''company_first'' oder ''signal_first''.' signal_types: type: array items: type: string description: Signaltypen, die dieser Monitor überwacht. signal_filters: type: array items: type: object description: >- Filter pro Signaltyp, wie gespeichert. Wenn Sie mit `query` erstellen, ist dies die Interpretation Ihres Satzes — prüfen Sie sie, um sicherzustellen, dass der Monitor das überwacht, was Sie beabsichtigt haben. company_filters: type: object description: >- Unternehmensprofilfilter, die auf jedes übereinstimmende Signal angewendet werden. companies: type: array items: type: string description: Überwachte Unternehmen (company_first). is_company_enrichment: type: boolean description: >- Ob Treffer mit Unternehmensdetails angereichert werden. is_people_enrichment: type: boolean description: >- Ob Treffer mit Personen und Kontakten angereichert werden. people_enrichment_configs: type: array items: type: object description: >- Einstellungen zur Personenanreicherung, wie gespeichert. destination_type: type: string description: Typ des Zustellziels. destination_config: type: object description: Details zum Zustellziel (E-Mails oder Webhook-URL). frequency_minute: type: integer description: Wie oft der Monitor ausgeführt wird, in Minuten. notification_email: type: string nullable: true description: >- Adresse, die über den Monitor selbst benachrichtigt wird. max_retry_per_trigger: type: integer description: Zulässige Wiederholungen pro Auslösung. retry_delay_second: type: integer description: Verzögerung zwischen Wiederholungen, in Sekunden. max_records_per_trigger: type: integer description: >- Maximale Anzahl der pro Auslösung zugestellten Datensätze. max_daily_trigger: type: integer description: Maximale Anzahl von Auslösungen pro Tag. max_failure_trigger: type: integer description: >- Aufeinanderfolgende Fehlschläge, bevor der Monitor stoppt. status: type: string enum: - draft - active - paused - inactive description: >- Lebenszyklusstatus, mit dem der Monitor erstellt wurde. masked_signature: type: string description: Maskierte Webhook-Signatur zur Anzeige. created_at: type: string format: date-time description: Zeitstempel der Erstellung des Monitors. signature: type: string format: uuid description: >- Webhook-Signatur zur Überprüfung von Payloads. Wird nur bei der Erstellung zurückgegeben. example: 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: {} companies: [] 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: - me@company.com 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 status: active masked_signature: 5••••••••••••••8b8 created_at: '2026-07-16T10:27:40.469Z' signature: 52209a0d-f1c8-4111-a685-ac86edc678b8 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Ungültige Anfrage. Die Anfrage war fehlerhaft formatiert oder enthielt ungültige Parameter. Prüfen Sie den Fehlercode und die Meldung für Details. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Rate-Limit überschritten. Es wurden zu viele Anfragen in einem bestimmten Zeitraum gestellt. Versuchen Sie es erneut, nachdem das Rate-Limit-Fenster zurückgesetzt wurde. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Interner Serverfehler. Auf dem Server ist ein unerwarteter Fehler aufgetreten. Wenden Sie sich an den Support, falls der Fehler weiterhin besteht. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten Aktionen sowie die zugehörigen Berechtigungen und Vorgänge repräsentiert. Sie können es über den Bereich [Settings](https://dashboard.pubrio.com/#/settings/) erstellen. in: header ````