> ## 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 interpretieren

> Zeigt eine Vorschau eines Monitors, bevor Sie ihn erstellen — verwandelt eine Anfrage in natürlicher Sprache (in beliebiger Sprache) in eine validierte **Entwurfs**-Konfiguration, die Sie prüfen, anpassen und anschließend an [Monitor erstellen](/de/api-reference/endpoint/monitors/create) übermitteln können. Der Aufruf ist beliebig oft sicher möglich: Es wird nur ein Entwurf erstellt, niemals ein Monitor gespeichert, Alarme gesendet oder Credits verbraucht. Verwenden Sie `intent`, um die Aktion auszuwählen; wenn weggelassen, wird eine englische Schlüsselwort-Heuristik angewendet, und nicht erkannte Eingaben werden standardmäßig als `create_monitor` behandelt.



## OpenAPI

````yaml de-openapi POST /monitors/interpret
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/interpret:
    post:
      tags:
        - Monitor
      summary: Monitor aus natürlicher Sprache interpretieren
      description: >-
        Zeigt eine Vorschau eines Monitors, bevor Sie ihn erstellen — verwandelt
        eine Anfrage in natürlicher Sprache (in beliebiger Sprache) in eine
        validierte **Entwurfs**-Konfiguration, die Sie prüfen, anpassen und
        anschließend an [Monitor
        erstellen](/de/api-reference/endpoint/monitors/create) übermitteln
        können. Der Aufruf ist beliebig oft sicher möglich: Es wird nur ein
        Entwurf erstellt, niemals ein Monitor gespeichert, Alarme gesendet oder
        Credits verbraucht. Verwenden Sie `intent`, um die Aktion auszuwählen;
        wenn weggelassen, wird eine englische Schlüsselwort-Heuristik
        angewendet, und nicht erkannte Eingaben werden standardmäßig als
        `create_monitor` behandelt.
      operationId: interpretMonitor
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
              properties:
                query:
                  type: string
                  maxLength: 2000
                  description: >-
                    Die Anfrage 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". Auf 2000 Zeichen begrenzt.
                intent:
                  type: string
                  enum:
                    - create_monitor
                    - dry_test
                    - execute
                    - analyze
                  description: >-
                    Welche Aktion ausgeführt werden soll (sprachunabhängig).
                    `create_monitor` (Standard): gibt eine Entwurfskonfiguration
                    zurück. `dry_test`: Entwurf plus eine schreibgeschützte
                    Zählung der aktuell übereinstimmenden Signale. `execute`:
                    Entwurf plus Vorschau, zur Bestätigung markiert (aktiviert
                    nie automatisch). `analyze` (z. B. "which market, SG or
                    JP?"): wird vom Expansion-Analyse-Agenten beantwortet,
                    anstatt einen Monitor zu erstellen. Wenn weggelassen, wird
                    eine englische Schlüsselwort-Heuristik verwendet; nicht
                    erkannte Eingaben werden standardmäßig als `create_monitor`
                    behandelt.
                deep:
                  type: boolean
                  description: >-
                    Führt den Reflection-Durchlauf für höhere Genauigkeit aus
                    (Standard true; verdoppelt in etwa die Latenz). Auf false
                    setzen für eine schnellere Einzeldurchlauf-Interpretation.
            example:
              query: >-
                monitor companies expanding into Japan, get C-level people with
                their work email, and email alerts to me@company.com in real
                time
      responses:
        '200':
          description: Der interpretierte Entwurf. Es wird nichts gespeichert.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      intent:
                        type: string
                        enum:
                          - create_monitor
                          - dry_test
                          - execute
                          - analyze
                        description: >-
                          Die aufgelöste Aktion (create_monitor / dry_test /
                          execute / analyze).
                      no_intent:
                        type: boolean
                        description: >-
                          true, wenn die Anfrage keine Monitor-Einrichtung war
                          (eine Begrüßung, themenfremd oder unsinnig); `config`
                          ist dann null.
                      config:
                        type: object
                        nullable: true
                        description: >-
                          Die Entwurfskonfiguration des Monitors, exakt geformt
                          wie der Request-Body von [Monitor
                          erstellen](/de/api-reference/endpoint/monitors/create)
                          (detection_mode, signal_types, signal_filters,
                          people_enrichment_configs,
                          destination_type/destination_config, frequency_minute,
                          status "draft" usw.). Übermitteln Sie sie an „Monitor
                          erstellen“, um sie zu aktivieren. Sie kann auch
                          `domains`/`linkedin_urls`/`company_names` enthalten,
                          die „Monitor erstellen“ zu Unternehmen auflöst. Null,
                          wenn `no_intent` true ist.
                      missing_fields:
                        type: array
                        items:
                          type: string
                        description: >-
                          Felder, die vor der Aktivierung des Monitors noch
                          erforderlich sind (z. B. "destination",
                          "signal_types", "companies"). Erfassen Sie diese in
                          Ihrer UI, bevor Sie an „Monitor erstellen“
                          übermitteln.
                      requires_confirmation:
                        type: boolean
                        description: >-
                          true für die Intent `execute` — die Konfiguration ist
                          bereit, aber der Benutzer muss vor der Aktivierung
                          bestätigen.
                      preview:
                        type: object
                        nullable: true
                        description: >-
                          Vorhanden bei `dry_test` und `execute`: eine
                          schreibgeschützte Schätzung, wie viele Signale aktuell
                          übereinstimmen, pro Signaltyp, über die letzten 30
                          Tage (gestichprobt). Es werden keine Credits
                          verbraucht.
                      interpretation:
                        type: object
                        description: >-
                          Echo der aus der Query extrahierten Rohfelder, zur
                          Anzeige oder zum Debugging.
              example:
                data:
                  intent: create_monitor
                  no_intent: false
                  config:
                    detection_mode: signal_first
                    signal_types:
                      - expansions
                    signal_filters:
                      - signal_type: expansions
                        filters:
                          tos:
                            - JP
                          stages:
                            - exploring
                            - committing
                    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
                    name: Expansion signals → JP
                    destination_type: email
                    destination_config:
                      emails:
                        - me@company.com
                    frequency_minute: 5
                    status: draft
                  missing_fields: []
                  requires_confirmation: false
                  preview: null
                  interpretation:
                    signal_types:
                      - expansions
                    tos:
                      - JP
                    management_levels:
                      - c_suite
                    people_contact_types:
                      - email-work
                    destination_email: me@company.com
                    is_realtime: true
        '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

````