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

# Einführung in Monitore

> Automatisierte Signalerkennung mit Anreicherung — in Echtzeit an Ihren Webhook oder Ihre E-Mail zugestellt.

## Warum Monitore?

Herkömmliche APIs erfordern, dass Sie Ihre eigene Signal-Pipeline aufbauen und pflegen — Endpunkte abfragen, Zustände verfolgen, Paginierung handhaben und mehrere Aufrufe für die Anreicherung zusammenfügen. Monitore ersetzen all das durch eine einzige Konfiguration.

<CardGroup cols={2}>
  <Card title="Echtzeit-Zustellung" icon="bolt">
    Signale werden erkannt und zugestellt, sobald sie auftreten — keine Polling-Schleifen oder Cron-Jobs erforderlich.
  </Card>

  <Card title="Kombinierte Filterung" icon="filter">
    Kombinieren Sie Signalfilter mit globalen Unternehmensfiltern in einer Abfrage. „Unternehmen mit 500+ Mitarbeitenden, die für KI-Rollen einstellen" — eine Konfiguration, nicht mehrere API-Aufrufe.
  </Card>

  <Card title="Automatische Anreicherung" icon="sparkles">
    Unternehmensprofile und Personenkontakte werden bei jedem Trigger automatisch angereichert. Keine separaten API-Aufrufe nötig.
  </Card>

  <Card title="Integrierte Zuverlässigkeit" icon="shield-check">
    Retry-Logik, Fehlerbehandlung, Deduplizierung und Zustellungsverfolgung — alles für Sie verwaltet.
  </Card>
</CardGroup>

<Frame caption="Einrichtung eines Monitors — Signale definieren, Daten anreichern und Ergebnisse in vier Schritten zustellen.">
  <img src="https://mintcdn.com/pubrio/ConxUMcWRGGOJNDN/images/monitor_signal_overview.png?fit=max&auto=format&n=ConxUMcWRGGOJNDN&q=85&s=de4446a02a411074eed9c21a9cabf4ec" alt="Monitor-Einrichtung — Signaltypen, Signalfilter und globale Unternehmensfilter definieren" width="3248" height="3336" data-path="images/monitor_signal_overview.png" />
</Frame>

***

## Wie Monitore funktionieren

<Tabs>
  <Tab title="1. Trigger">
    <Frame>
      <img src="https://mintcdn.com/pubrio/ConxUMcWRGGOJNDN/images/monitor_trigger.png?fit=max&auto=format&n=ConxUMcWRGGOJNDN&q=85&s=198cde72f0e86fa3824e074b839f91b6" alt="Monitor-Einrichtung — Signaltypen, Signalfilter und globale Unternehmensfilter definieren" width="5760" height="3252" data-path="images/monitor_trigger.png" />
    </Frame>
  </Tab>

  <Tab title="2. Anreicherung">
    <Frame>
      <img src="https://mintcdn.com/pubrio/ConxUMcWRGGOJNDN/images/monitor_enrichment.png?fit=max&auto=format&n=ConxUMcWRGGOJNDN&q=85&s=c63a9b421bdc949d88a4c2209c50c13a" alt="Monitor-Einrichtung — Unternehmensanreicherung und Personensuche-Ebenen konfigurieren" width="5760" height="3908" data-path="images/monitor_enrichment.png" />
    </Frame>
  </Tab>

  <Tab title="3. Zustellung">
    <Frame>
      <img src="https://mintcdn.com/pubrio/ConxUMcWRGGOJNDN/images/monitor_delivery.png?fit=max&auto=format&n=ConxUMcWRGGOJNDN&q=85&s=810e7e65e7ec529ea3d7e9c21d7d9d13" alt="Monitor-Einrichtung — Zieltyp wählen, Webhook oder E-Mail konfigurieren, Sync-Intervall festlegen" width="5760" height="4868" data-path="images/monitor_delivery.png" />
    </Frame>
  </Tab>

  <Tab title="4. Vorschau">
    <Frame>
      <img src="https://mintcdn.com/pubrio/ConxUMcWRGGOJNDN/images/monitor_preview.png?fit=max&auto=format&n=ConxUMcWRGGOJNDN&q=85&s=968cd72d4dc4ec0ea08f5f40d154fd7d" alt="Monitor-Einrichtung — Konfiguration und Fehlerbehandlung überprüfen und den Monitor erstellen" width="5760" height="3252" data-path="images/monitor_preview.png" />
    </Frame>
  </Tab>
</Tabs>

<Steps>
  <Step title="Definieren Sie Ihre Filter">
    Wählen Sie, welche Signale verfolgt werden sollen (Jobs, News, Anzeigen, Expansionen), und legen Sie Filter auf Signalebene fest. Optional können Sie **globale Unternehmensfilter** hinzufügen, um die Ergebnisse einzugrenzen — zum Beispiel nur Signale von Unternehmen mit 500+ Mitarbeitenden in den USA anzeigen.
  </Step>

  <Step title="Pubrio scannt in Echtzeit">
    Mit `frequency_minute` auf `0` gesetzt (Standard) läuft Ihr Monitor in Echtzeit — Signale werden erkannt und zugestellt, sobald sie auftreten.
  </Step>

  <Step title="Ergebnisse werden automatisch angereichert">
    Übereinstimmende Signale werden mit vollständigen Unternehmensprofilen und optional Personenkontakten angereichert — alles in einem einzigen Trigger. Keine zusätzlichen Aufrufe nötig.
  </Step>

  <Step title="Zustellung an Ihr Ziel">
    Die Ergebnisse gehen an Ihren Webhook-Endpunkt oder Ihr E-Mail-Postfach. Über die Dashboard-Endpunkte erhalten Sie außerdem vollständige Statistiken und Log-Verläufe.
  </Step>
</Steps>

***

## Erkennungsmodi

Jeder Monitor arbeitet in einem von zwei Erkennungsmodi:

<Tabs>
  <Tab title="Signal First">
    **Signale treiben die Entdeckung.** Sie definieren, nach welchen Signalen gesucht werden soll — das System findet übereinstimmende Signale über alle Unternehmen hinweg und reichert die Ergebnisse dann an.

    Verwenden Sie **globale Unternehmensfilter** (`company_filters`) als zweite Ebene, um einzugrenzen, welche Unternehmen infrage kommen. Beispiel: „Finde alle KI-Stellenausschreibungen, aber nur von Unternehmen mit 1.000+ Mitarbeitenden."

    Am besten geeignet für:

    * Breite Marktscans und Trend-Erkennung
    * Das Finden neuer Unternehmen, die Sie noch nie verfolgt haben
    * Signalgetriebenes Prospecting in großem Maßstab

    ```
    Signalfilter → Übereinstimmende Signale → Globale Unternehmensfilter (optional) → Anreicherung → Zustellung
    ```
  </Tab>

  <Tab title="Company First">
    **Bestimmte Unternehmen treiben die Entdeckung.** Sie geben eine Liste von Zielunternehmen über `companies`, `domains` oder `linkedin_urls` an, und das System überwacht sie auf übereinstimmende Signale.

    **Globale Unternehmensfilter** (`company_filters`) gelten auch hier weiterhin als zweite Ebene — nützlich, wenn Sie eine Watchlist mit breiteren Kriterien kombinieren möchten.

    Am besten geeignet für:

    * Verfolgung benannter Accounts („benachrichtige mich, wenn OpenAI neue Jobs ausschreibt")
    * Wettbewerbsbeobachtung bei bestimmten Unternehmen
    * Account-basierte Monitoring-Pipelines

    ```
    Zielunternehmen (companies / domains / linkedin_urls) → Signalfilter → Globale Unternehmensfilter (optional) → Anreicherung → Zustellung
    ```
  </Tab>
</Tabs>

***

## Signaltypen

Monitore unterstützen derzeit vier Signaltypen, wobei regelmäßig weitere hinzukommen:

<CardGroup cols={2}>
  <Card title="Jobs" icon="briefcase">
    Neue Stellenausschreibungen — filterbar nach Titel, Standort, Ausschreibungsdatum und mehr.
  </Card>

  <Card title="News" icon="newspaper">
    Unternehmensnachrichten — Produktstarts, Partnerschaften, Finanzierungsrunden, Führungswechsel und mehr.
  </Card>

  <Card title="Anzeigen" icon="bullhorn">
    Aktive Werbekampagnen — filterbar nach Zielstandort, Zeitraum und Schlüsselwörtern.
  </Card>

  <Card title="Expansionen" icon="globe">
    Belege für Marktexpansion — ein Unternehmen tritt in einen neuen Markt ein oder wächst dort, filterbar nach Korridor, Phase und Signalstärke.
  </Card>
</CardGroup>

### Was jedes Signal zeigt

| Signaltyp       | Was es offenbart                                                                                                                                                                      | Beispielhafte Anwendungsfälle                                                                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Jobs**        | Ein Unternehmen stellt aktiv ein — ein Hinweis auf Wachstum, neue Initiativen oder Budgetzuweisung in bestimmten Abteilungen.                                                         | Ein Anstieg bei Engineering-Einstellungen deutet oft auf den Aufbau eines neuen Produkts hin. Vertriebseinstellungen legen Umsatzwachstum nahe.                             |
| **News**        | Meilensteine des Unternehmens — Finanzierungsrunden, Produktstarts, Partnerschaften, Führungswechsel oder Herausforderungen.                                                          | Eine Finanzierungsankündigung ist ein idealer Zeitpunkt für eine Kontaktaufnahme. Führungswechsel schaffen neue Gelegenheiten bei Entscheidungsträgern.                     |
| **Anzeigen**    | Wo und wie ein Unternehmen für Marketing ausgibt — offenbart Expansionspläne, Zielmärkte und Wettbewerbspositionierung.                                                               | Hohe Werbeausgaben in einer neuen Region signalisieren den Markteintritt. Wettbewerber mit ähnlichen Kampagnen zeigen Marktaktivität an.                                    |
| **Expansionen** | Ein Unternehmen tritt in einen bestimmten Markt ein oder skaliert dort — belegt durch datierte, quellenbasierte Nachweise wie lokale Einstellungen, ein Büro oder eine Registrierung. | Ein Unternehmen, das in Ihrem Gebiet die Phase `expanding` erreicht, ist ein zeitlich begrenztes Fenster. Kontraktionssignale markieren Accounts, die man pausieren sollte. |

### Zustellungsrhythmus

Sie steuern über `frequency_minute`, wie oft Ihr Monitor nach neuen Signalen scannt:

| Einstellung        | Verhalten                                                                  | Am besten für                                                       |
| ------------------ | -------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| **`0` (Standard)** | **Echtzeit** — Signale werden erkannt und zugestellt, sobald sie auftreten | Zeitkritische Alarme, Wettbewerbsbeobachtung                        |
| `15`               | Alle 15 Minuten                                                            | Hochprioritäres Monitoring mit vorhersehbarer Zustellung            |
| `60`               | Stündlich                                                                  | Ausgewogene Frequenz für Monitore mit moderatem Volumen             |
| `1440`             | Täglich                                                                    | Digest-artige Zusammenfassungen, Tracking mit niedrigerer Priorität |

<Info>
  Die Signalbibliothek wird kontinuierlich erweitert. Neue Signaltypen werden hinzugefügt, sobald sie verfügbar sind — Ihre bestehenden Monitore sind davon nicht betroffen, wenn neue Typen eingeführt werden.
</Info>

***

## Globale Unternehmensfilter

Eine der leistungsstärksten Funktionen von Monitoren ist die Möglichkeit, Signalfilter mit **globalen Unternehmensfiltern** zu kombinieren. Das bedeutet, Sie können Kriterien wie diese definieren:

* „Unternehmen mit **500+ Mitarbeitenden**, die **für KI-Rollen einstellen**"
* „**US-amerikanische SaaS-Unternehmen**, die in **News zu Produktstarts** erschienen sind"
* „Unternehmen, die **bestimmte Technologien** nutzen und **Werbekampagnen** in Europa durchführen"

Globale Unternehmensfilter (`company_filters`) akzeptieren dieselben Parameter wie der Endpunkt [Company Search](/de/api-reference/endpoint/companies/search) — Standorte, Mitarbeitergröße, Branchen, Technologien, Verticals und mehr.

<Note>
  Im Modus `company_first` verwenden Sie `companies` (domain\_search\_ids), `domains` oder `linkedin_urls`, um Ihre Zielunternehmensliste festzulegen — nur eines davon ist erforderlich. `company_filters` fügt in beiden Modi zusätzliche Filterkriterien hinzu.
</Note>

***

## Personenanreicherung

Wenn Sie die Personenanreicherung aktivieren, findet jeder Trigger automatisch relevante Kontakte bei den übereinstimmenden Unternehmen. Konfigurieren Sie `people_enrichment_configs` mit:

* **Filter** — Managementebenen, Abteilungen, Titel, Standorte — dieselben Parameter wie beim Endpunkt [People Search](/de/api-reference/endpoint/people/search)
* **Kontakttypen** — `email-work`, `email-personal`, `phone` — entsprechen den Kontakttypen des Endpunkts [Redeem](/de/api-reference/endpoint/redeem/people)
* **Maximale Anzahl zurückzugebender Personen** — 1 bis 25 pro Konfigurationsebene

Sie können **mehrere Anreicherungsebenen** definieren, jede mit unterschiedlichen Filtern. Zum Beispiel eine Ebene für C-Level-Führungskräfte und eine weitere für Engineering-Direktoren. Jede Ebene führt eine unabhängige Personensuche aus.

<Note>
  Jede Anreicherungsebene verbraucht pro Trigger Personensuche-Credits, unabhängig davon, wie viele Personen zurückgegeben werden. Planen Sie Ihre Ebenen anhand der jeweiligen Zielgruppen, die Sie benötigen.
</Note>

***

## Credits verstehen

Jeder Monitor-Trigger verbraucht Credits basierend darauf, was er verarbeitet. Die aktuellen Credit-Sätze finden Sie auf der Seite [Pricing](/de/get-started/pricing).

| Credit-Typ               | Wie er verbraucht wird                                                                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Trigger-Credit**       | 10 Credits pro Trigger                                                                                                                                       |
| **Unternehmens-Credit**  | Pro angereichertem Unternehmen in den Ergebnissen                                                                                                            |
| **Personensuche-Credit** | Pro Anreicherungsebene in `people_enrichment_configs` — jede Ebene führt eine Personensuche aus (gleiche Credit-Kosten wie der Endpunkt People Search)       |
| **Redeem-Credit**        | Pro eingelöster Person — nur bei erfolgreichem Abruf berechnet, unabhängig von der Anzahl der pro Person zurückgegebenen E-Mail-Adressen oder Telefonnummern |

### Beispiel

Ein Monitor, konfiguriert mit `is_company_enrichment: true`, einer Personenanreicherungsebene mit E-Mail-Einlösung und `max_records_per_trigger: 5`, löst aus und findet 3 Unternehmen mit je 2 Personen:

| Komponente      | Berechnung                                                     | Credits                         |
| --------------- | -------------------------------------------------------------- | ------------------------------- |
| Trigger         | 1 Trigger                                                      | 10                              |
| Unternehmen     | 3 angereicherte Unternehmen                                    | 3                               |
| Personensuche   | 1 Anreicherungsebene                                           | Personensuche-Credits           |
| Personen-Redeem | 6 eingelöste Personen (3 × 2, pro Person bei Erfolg berechnet) | 6 × Redeem-Satz                 |
| **Gesamt**      |                                                                | **13 + Personensuche + Redeem** |

<Tip>
  Credit-Sätze können sich ändern — prüfen Sie stets die Seite [Pricing](/de/get-started/pricing) für die aktuellen Informationen. Aktivieren Sie die Personenanreicherung nur, wenn Sie Kontaktdaten benötigen.
</Tip>

***

## Zieltypen

<AccordionGroup>
  <Accordion title="Webhook" icon="globe" defaultOpen>
    Empfangen Sie Ergebnisse als JSON-Payload an Ihrem HTTP-Endpunkt. Fügen Sie benutzerdefinierte Header und Body-Felder für die Authentifizierung hinzu. Überprüfen Sie die Echtheit der Zustellung anhand der Signatur des Monitors.

    Dies ist das empfohlene Ziel für Entwickler. Eine vollständige Anleitung finden Sie unter [Setting up Webhooks](/de/developer-guides/setting-up-webhooks).
  </Accordion>

  <Accordion title="E-Mail" icon="envelope">
    Empfangen Sie formatierte Ergebnisse per E-Mail. Unterstützt White-Label-Branding für Agenturen und Teams.

    Interessiert an White-Label-E-Mail-Zustellung? [Kontaktieren Sie uns](https://pubrio.com/en/get-in-touch), um mehr zu erfahren.
  </Accordion>

  <Accordion title="Sequenzen" icon="arrow-progress">
    Übereinstimmende Kontakte automatisch in eine Outreach-Sequenz aufnehmen. Erfordert `sequence_identifier` und `record_type` in `destination_config`.

    Konfigurationsdetails finden Sie in der Referenz zum Endpunkt [Create Monitor](/de/api-reference/endpoint/monitors/create).
  </Accordion>
</AccordionGroup>

***

## Konfigurationsreferenz

Alle Konfigurationsparameter haben sinnvolle Standardwerte. In den meisten Fällen müssen Sie nur die Filter und das Ziel festlegen — alles andere ist optional.

| Parameter                 | Bereich   | Standard | Beschreibung                                        |
| ------------------------- | --------- | -------- | --------------------------------------------------- |
| `frequency_minute`        | 0 - 10080 | 0        | Minuten zwischen Scans. **`0` = Echtzeit.**         |
| `max_records_per_trigger` | 1 - 100   | 25       | Maximale Anzahl an Datensätzen pro Trigger.         |
| `max_daily_trigger`       | 0 - 86400 | 500      | Tägliche Obergrenze für Trigger. `0` = unbegrenzt.  |
| `max_retry_per_trigger`   | 0 - 3     | 1        | Wiederholungsversuche bei Zustellungsfehler.        |
| `retry_delay_second`      | 1 - 5     | 1        | Sekunden zwischen Wiederholungsversuchen.           |
| `max_failure_trigger`     | 1 - 10    | 5        | Aufeinanderfolgende Fehler vor automatischer Pause. |

***

## Filterreferenz

Signal- und Unternehmensfilter verwenden dieselben Schemas wie die Such-Endpunkte:

<CardGroup cols={2}>
  <Card title="Job-Signalfilter" icon="briefcase" href="/de/api-reference/endpoint/companies/job_search">
    Dieselben Filter wie bei Job Search — Titel, Standorte, Ausschreibungsdaten und mehr.
  </Card>

  <Card title="News-Signalfilter" icon="newspaper" href="/de/api-reference/endpoint/companies/news_search">
    Dieselben Filter wie bei News Search — Kategorien, Galerien, Schlüsselwörter und Daten.
  </Card>

  <Card title="Anzeigen-Signalfilter" icon="bullhorn" href="/de/api-reference/endpoint/companies/advertisements_search">
    Dieselben Filter wie bei Advertisements Search — Zielstandorte, Zeiträume und Schlüsselwörter.
  </Card>

  <Card title="Globale Unternehmensfilter" icon="building" href="/de/api-reference/endpoint/companies/search">
    Dieselben Filter wie bei Company Search — Standorte, Größe, Branchen, Technologien, Verticals und mehr.
  </Card>

  <Card title="Expansion-Signalfilter" icon="globe" href="/de/api-reference/endpoint/expansions/market_lookup">
    Dieselben Filter wie bei Expansion Search — `froms` / `tos`, Phasen, Geltungsbereiche, Momentum, Aktualität und Signaltypen.
  </Card>
</CardGroup>

<Note>
  Filter für die Personenanreicherung (Managementebenen, Abteilungen, Titel) folgen derselben Struktur wie der Endpunkt [People Search](/de/api-reference/endpoint/people/search).
</Note>

***

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Webhooks einrichten" icon="plug" href="/de/developer-guides/setting-up-webhooks">
    Verbinden Sie Ihre Systeme, um Daten in Echtzeit zu empfangen.
  </Card>

  <Card title="Best Practices" icon="star" href="/de/developer-guides/best-practices">
    Frequenz, Zustellzuverlässigkeit und Fehlerbehandlung.
  </Card>

  <Card title="Beispiel: Jobs verfolgen" icon="code" href="/de/developer-guides/examples/tracking-job-postings">
    Vollständige company\_first- und signal\_first-Anleitungen mit kopierbarem Code.
  </Card>

  <Card title="Create Monitor" icon="book" href="/de/api-reference/endpoint/monitors/create">
    Direkt zur Referenz des Endpunkts Create Monitor.
  </Card>
</CardGroup>