Skip to main content
POST
Monitor aktualisieren

Autorisierungen

pubrio-api-key
string
header
erforderlich

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

Body

application/json
monitor_id
string<uuid>
erforderlich

Eindeutige Kennung des zu aktualisierenden Monitors.

name
string

Name des Monitors.

description
string

Beschreibung des Monitors.

detection_mode
enum<string>

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.

Verfügbare Optionen:
company_first,
signal_first
signal_types
enum<string>[]

Zu überwachende Signaltypen.

Verfügbare Optionen:
jobs,
news,
advertisements,
expansions,
cloud_footprints
signal_filters
object[]

Ein Eintrag pro Signal-Stream, den der Monitor überwacht.

Beispiel:
company_filters
object

Globale Unternehmensfilter, die als zweite Ebene über alle Signaltypen hinweg angewendet werden. Akzeptiert dieselben Parameter wie der Unternehmenssuche-Endpunkt — Standorte, Mitarbeiterzahl, Technologien, Branchen und mehr.

Beispiel:
companies
string<uuid>[]

Liste von domain_search_id-UUIDs von Unternehmen. Alternative: domains oder linkedin_urls verwenden.

domains
string[]

Liste von Unternehmensdomains. Alternative zu companies.

linkedin_urls
string<uri>[]

Liste von LinkedIn-Unternehmens-URLs. Alternative zu companies.

is_company_enrichment
boolean

Ob Unternehmensdaten angereichert werden sollen.

is_people_enrichment
boolean

Ob Personendaten angereichert werden sollen.

people_enrichment_configs
object[]

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-Kontakttypen: email-work, email-personal, phone) und filters (dieselben Parameter wie der Personensuche-Endpunkt).

Beispiel:
destination_type
enum<string>

Typ des Zustellziels.

Verfügbare Optionen:
webhook,
email,
sequences
destination_config
object

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.

Beispiel:
frequency_minute
integer

Auslösefrequenz in Minuten. Min: 0, Max: 10080, Standard: 0.

Erforderlicher Bereich: 0 <= x <= 10080
max_failure_trigger
integer

Maximale Anzahl aufeinanderfolgender Fehlschläge vor der Pausierung. Min: 1, Max: 10, Standard: 5.

Erforderlicher Bereich: 1 <= x <= 10
max_daily_trigger
integer

Maximale Anzahl von Auslösungen pro Tag. Min: 0, Max: 86400, Standard: 500.

Erforderlicher Bereich: 0 <= x <= 86400
max_records_per_trigger
integer

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.

Erforderlicher Bereich: 1 <= x <= 100
excluded_companies
string[]

Unternehmen, die dieser Monitor nie liefert oder abrechnet, als domain_search_id-UUIDs. Gilt in beiden Erkennungsmodi zur Laufzeit, vor Anreicherung und Abrechnung; ein Unternehmen, das sowohl in companies als auch in dieser Liste steht, ist ausgeschlossen, solange es auf der Liste steht. Maximale Listengröße: 100.000 (aufgelöste IDs aus excluded_companies, excluded_domains und excluded_linkedin_urls).

Beispiel:
excluded_domains
string[]

Auszuschließende Unternehmensdomains (z. B. ["existing-client.com"]). Werden zu Unternehmen aufgelöst und in excluded_companies übernommen.

Beispiel:
excluded_linkedin_urls
string[]

Auszuschließende LinkedIn-Unternehmens-URLs. Werden zu Unternehmen aufgelöst und in excluded_companies übernommen.

Beispiel:
companies_mode
enum<string>

Wie die gesendeten companies / domains / linkedin_urls auf die gespeicherte Beobachtungsliste treffen: replace (Standard) ersetzt die ganze Liste, add hängt die gesendeten Unternehmen an, remove entfernt sie. Nicht gesendete Listen bleiben unberührt.

Verfügbare Optionen:
replace,
add,
remove
Beispiel:

"add"

excluded_companies_mode
enum<string>

Dasselbe für die Ausschlussliste (excluded_companies / excluded_domains / excluded_linkedin_urls): replace (Standard), add oder remove.

Verfügbare Optionen:
replace,
add,
remove
Beispiel:

"add"

record_unit
enum<string>

Was ein gelieferter Datensatz ist: signal (Payload signals[], ein Eintrag pro Signal) oder company (Payload companies[], ein Eintrag pro Unternehmen mit verschachtelten Signalen). Standard folgt detection_mode: signal_first → signal, company_first → company. Die Limits (max_records_per_trigger, max_daily_records) zählen diese Einheit.

Verfügbare Optionen:
signal,
company
Beispiel:

"company"

company_dedupe_days
integer

Ein Unternehmen erscheint höchstens in einer Lieferung pro so vielen Tagen, über alle Signaltypen des Monitors; ein innerhalb des Fensters geliefertes Unternehmen bleibt aus späteren Lieferungen draußen und seine späteren Signale im Fenster werden übersprungen, nicht aufgeschoben. 0 = aus. Standard: 0.

Erforderlicher Bereich: x >= 0
Beispiel:

30

is_newest_first
boolean

Die frischesten passenden Signale zuerst liefern. Bei einem Trigger- oder Tageslimit bleiben die neuesten Datensätze, und der Cursor des Monitors rückt trotzdem bis zur neuesten geholten Zeile vor, sodass ältere Zeilen übersprungen und nie nachgeliefert werden. Standard false (älteste zuerst, nichts übersprungen).

Beispiel:

true

max_daily_records
integer

Hartes Limit gelieferter Datensätze pro Kalendertag in der Zeitzone des Besitzers (0 = unbegrenzt). Gezählt in der Datensatzeinheit des Monitors über erfolgreiche Lieferungen; ein Trigger liefert höchstens das Restbudget, danach wartet der Monitor bis zum nächsten Tag, ohne seinen Cursor zu bewegen. Standard: 0.

Erforderlicher Bereich: x >= 0
Beispiel:

200

notification_email
string<email>

E-Mail für Fehlerbenachrichtigungen.

max_retry_per_trigger
integer

Maximale Wiederholungen pro Auslösung. Min: 0, Max: 3, Standard: 1.

Erforderlicher Bereich: 0 <= x <= 3
retry_delay_second
integer

Verzögerung zwischen Wiederholungen in Sekunden. Min: 1, Max: 5, Standard: 1.

Erforderlicher Bereich: 1 <= x <= 5
status
enum<string>

Zu setzender Lebenszyklusstatus. Das Ändern des Status setzt den Fehlerzähler zurück.

Verfügbare Optionen:
draft,
active,
paused,
inactive

Antwort

Erfolgreiche Antwort mit dem aktualisierten Monitor. Die Antwort enthält immer monitor_id, name, detection_mode, destination_type, status, masked_signature und last_modified sowie alle weiteren Spalten, die Teil der Aktualisierung waren.

metadata
object
data
object

Der aktualisierte Monitor. Alle weiteren in der Aktualisierung enthaltenen Spalten werden ebenfalls zurückgegeben.

Zuletzt geändert am 4. September 2026