> ## 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. # Werbe-Insights für Unternehmen > Aggregierte Einblicke in Werbesignale für ein Unternehmen über einen Zeitraum: Anzahl aktiver und gestarteter Anzeigen, Kanal- und Platzierungsmix, Creative-Beispiele, Zielgruppenreichweite als Stufenverteilung und eine wöchentliche Zeitreihe. Die Reichweite wird als Verteilung über Stufen ausgewiesen, niemals als einzelne summierte Zahl. ## OpenAPI ````yaml de-openapi POST /companies/advertisements/insights 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: /companies/advertisements/insights: post: tags: - Insights summary: Werbeanzeigen-Insights description: >- Aggregierte Einblicke in Werbesignale für ein Unternehmen über einen Zeitraum: Anzahl aktiver und gestarteter Anzeigen, Kanal- und Platzierungsmix, Creative-Beispiele, Zielgruppenreichweite als Stufenverteilung und eine wöchentliche Zeitreihe. Die Reichweite wird als Verteilung über Stufen ausgewiesen, niemals als einzelne summierte Zahl. operationId: companies_advertisements_insights requestBody: required: true content: application/json: schema: type: object required: - domain_search_id properties: domain_search_id: $ref: '#/components/schemas/domain_search_id' date_from: $ref: '#/components/schemas/date_from' date_to: $ref: '#/components/schemas/date_to' is_include_unlinked_companies: type: boolean example: false description: >- Werbeanzeigen einbeziehen, die noch nicht mit einem verifizierten Unternehmensprofil verknüpft sind. responses: '200': description: Werbe-Insight-Bänder für das Unternehmen und den Zeitraum. content: application/json: schema: type: object properties: data: type: object description: >- Insight-Bänder für das angeforderte Unternehmen und den Zeitraum. properties: postings: type: array description: >- Anzeigenvolumen-Rollup, gruppiert nach Reichweitenstufe, Märkten, Kanal und Format. Schlüssel sind abgekürzt, um die Payload klein zu halten: `r` = Reichweitenstufen-Slug (entspricht `reach_tiers[].slug`, `null`, wenn die Plattform keine Reichweite meldet), `m` = die ISO-3166-1-Alpha-2-Märkte, in denen die Anzeigen geschaltet wurden, `ch` = Quellkanal, `fo` = Anzeigenformat, `n` = Anzahl der Anzeigen in dieser Gruppe. items: type: object reach_tiers: type: array description: >- Der Katalog der Reichweitenstufen-Labels, sortiert von kleinster zu größter. Dies ist eine Nachschlagetabelle, keine Verteilung — sie enthält keine Zählwerte. Verknüpfen Sie `postings[].r` mit `slug`, um das menschenlesbare Label zu erhalten, und lesen Sie das Volumen pro Stufe aus `postings[].n`. Die Anzeigenreichweite ist an der Quelle ein Textbereich, daher dürfen Stufen niemals zu einer einzelnen Reichweitenzahl summiert werden. items: type: object creatives: type: array description: >- Aktuelle Anzeigen-Creatives, bildgeführt: Creatives mit einem echten Bild stehen zuerst, dann aktuelle Text- oder Video-Anzeigen, damit auch Werbetreibende ohne Bild erscheinen. `headline`, `body` und `cta` können jeweils `null` sein. Alles, was zur Darstellung einer Creative-Galerie benötigt wird, ist hier enthalten — ein zweiter Aufruf der Anzeigen-Suche ist nicht erforderlich. items: type: object example: data: totals: total: 14 launched: 4 active: 4 markets: 46 channels: 2 weekly_series: - week_start: '2026-05-25' count: 4 postings: - r: 10k_50k m: - PE - KR - VE - AR ch: facebook fo: video 'n': 1 placement_mix: - key: INSTAGRAM count: 10 creatives: - advertisement_search_id: 29fbc4ec-d9f2-40dc-be00-c96856271f8c image_url: >- https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg headline: null cta: Learn more advertisement_url: https://www.facebook.com/ads/library?id=1234567890 destination_url: https://www.instagram.com/youtube advertiser: YouTube body: this video lives rent free in our minds format: image has_video: false reach_tiers: - slug: lt_1k label: < 1K - slug: 1k_10k label: 1K–10K - slug: 10k_50k label: 10K–50K - slug: 50k_100k label: 50K–100K - slug: 100k_500k label: 100K–500K window_days: 90 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: domain_search_id: type: string format: uuid description: Eine eindeutige Kennung für den Unternehmenssuchvorgang. date_from: type: string format: date example: '2026-01-01' description: >- Beginn des Datumsfensters (ISO 8601, JJJJ-MM-TT). Zusammen mit `date_to` verwenden, um Ergebnisse auf einen bestimmten Bereich zu beschränken; beide weglassen, um das Standardfenster zu verwenden. date_to: type: string format: date example: '2026-03-31' description: >- Ende des Datumsfensters (ISO 8601, JJJJ-MM-TT). Muss auf oder nach `date_from` liegen. 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 ````