> ## 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. # Unternehmenswerbung durchsuchen > Von Unternehmen geschaltete Werbeanzeigen durchsuchen. Siehe den [Advertisement-Search-Leitfaden](/de/developer-guides/search/advertisement-search). ## OpenAPI ````yaml de-openapi POST /companies/advertisements/search 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/search: post: tags: - Search summary: Nach Unternehmenswerbeanzeigen suchen description: >- Von Unternehmen geschaltete Werbeanzeigen durchsuchen. Siehe den [Advertisement-Search-Leitfaden](/de/developer-guides/search/advertisement-search). operationId: companies_search_advertisements parameters: [] requestBody: required: true content: application/json: schema: type: object properties: target_locations: $ref: '#/components/schemas/target_locations' exclude_target_locations: $ref: '#/components/schemas/exclude_target_locations' search_terms: $ref: '#/components/schemas/search_terms' headlines: $ref: '#/components/schemas/headlines' filter_conditions: $ref: '#/components/schemas/ads_filter_conditions' start_dates: $ref: '#/components/schemas/start_dates' end_dates: $ref: '#/components/schemas/end_dates' active_dates: $ref: '#/components/schemas/advertisement_active_dates_search' created_at: $ref: '#/components/schemas/search_created_at' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' advertisement_search_id: allOf: - $ref: '#/components/schemas/advertisement_search_id' description: >- Nur diesen einen Datensatz zurückgeben. Praktisch, um eine zuvor gespeicherte Zeile ohne Paginierung erneut abzurufen. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' advertisement_formats: $ref: '#/components/schemas/advertisement_formats' reach_tiers: $ref: '#/components/schemas/advertisement_reach_tiers' advertisement_active_ads: $ref: '#/components/schemas/advertisement_active_ads' advertisement_running_ads: $ref: '#/components/schemas/advertisement_running_ads' advertisement_total_ads: $ref: '#/components/schemas/advertisement_total_ads' advertisement_platform_count: $ref: '#/components/schemas/advertisement_platform_count' advertisement_format_count: $ref: '#/components/schemas/advertisement_format_count' advertisement_impressions_estimate: $ref: '#/components/schemas/advertisement_impressions_estimate' advertisement_country_activity: $ref: '#/components/schemas/advertisement_country_activity' source_types: $ref: '#/components/schemas/advertisement_source_types' exclude_source_types: $ref: '#/components/schemas/advertisement_exclude_source_types' enrichment_mode: $ref: '#/components/schemas/advertisement_enrichment_mode' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' publisher_platforms: $ref: '#/components/schemas/advertisement_publisher_platforms' exclude_publisher_platforms: $ref: >- #/components/schemas/advertisement_exclude_publisher_platforms is_include_unlinked_companies: $ref: >- #/components/schemas/advertisement_is_include_unlinked_companies responses: '200': description: >- Erfolgreiche Antwort mit Details zur Unternehmens-Werbeanzeigensuche. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/advertisement_search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' advertisements: type: array items: $ref: '#/components/schemas/advertisement_search_result' example: metadata: profile: null filters: source_types: - linkedin per_page: 25 language: en ignored_fields: [] applied_source_types: - linkedin data: pagination: page: 1 per_page: 25 total_entries: 694356 total_pages: 27775 total_display_pages: 250 is_timeout: false advertisements: - target_country_codes: - US - GB - SG advertisement_id: 3af8cb80-9a04-49a8-832d-333961d5f77a advertisement_search_id: 3af8cb80-9a04-49a8-832d-333961d5f77a created_at: '2026-03-03T01:46:35.909Z' last_modified: '2026-03-03T12:46:25.289Z' started_at: '2026-02-25T00:00:00.000Z' ended_at: '2026-03-02T00:00:00.000Z' title: Thuraya-4 Satellite Solutions for Energy source_type: linkedin advertisement_format: Single Image Ad video_url: null image_url: >- https://buckets.pubrio.com/images/public/cL1U5ghYPAy65qc4cu5wtmgzv8P9xJgrofNTwohPWsyT3S5ob2zNp6Jov1nM9aaDRy.jpg carousel_images: null destination_url: >- https://www.thuraya.com/en/thuraya-4-ngs/home/index.html?trk=ad_library_ad_preview_headline_content companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjA3NTQ4NjQyM2lsajlzc25qMXNwYWNlNDIuYWlsaW5rZWRpbl82NDIyMjM3NA==.jpg domain_search_id: fe3963dc-87a4-4016-8c95-217ea68cd57a company_name: Space42 linkedin_name: space42ai country_code: AE domain: space42.ai raw_link_url: null publisher_platforms: null advertisement_format_normalized: image is_company_matched: true advertiser: Thuraya advertiser_url: https://www.linkedin.com/company/thuraya advertisement_url: https://www.linkedin.com/ad-library/detail/1518455034 total_impressions: < 1k total_impressions_lower: null total_impressions_upper: 1000 - target_country_codes: - US - GB - SG advertisement_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 advertisement_search_id: 47eb6229-e7aa-427f-bcd3-76e154fd5022 created_at: '2026-06-03T22:00:33.035Z' last_modified: '2026-06-05T18:15:51.823Z' started_at: '2026-05-25T07:00:00.000Z' ended_at: '2026-06-03T07:00:00.000Z' title: Dubai Opportunities. One Exclusive Event source_type: facebook advertisement_format: DCO video_url: null image_url: >- https://buckets.pubrio.com/images/public/4snZgJwKCWEYwAUwxrkkK1ooEFEAMF92Xet6Bm16oAyqwUSoqekDjX8S9DmfixutuH.jpg carousel_images: null destination_url: >- https://promotions.damacproperties.com/en/event-in-egypt-social-specific/ raw_link_url: http://fb.me/ publisher_platforms: - facebook - instagram companies: logo_url: >- https://buckets.pubrio.com/company-logo/MjYwODA0MjRkYW1hY3Byb3BlcnRpZXMuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 9da7386c-5bdc-42b2-8fee-456e91024a3a company_name: Damac Properties linkedin_name: damac-properties country_code: AE domain: damacproperties.com advertisement_format_normalized: image is_company_matched: true advertiser: Thuraya advertiser_url: https://www.linkedin.com/company/thuraya advertisement_url: https://www.linkedin.com/ad-library/detail/1518455034 total_impressions: < 1k total_impressions_lower: null total_impressions_upper: 1000 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filtert Anzeigen, um solche einzuschließen, die auf bestimmte Standorte anhand des Ländercodes abzielen. Damit finden Sie Anzeigen, die in bestimmten Ländern geschaltet werden. Wird mit `filter_conditions` über den OR-Operator kombiniert – die Anzeige muss auf mindestens einen der angegebenen Standorte abzielen. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filtert Anzeigen, um solche auszuschließen, die auf bestimmte Standorte anhand des Ländercodes abzielen. Damit blenden Sie Anzeigen aus, die in bestimmten Ländern geschaltet werden. Wird in `filter_conditions` mit dem Operator „or“ angegeben, darf die Anzeige auf keinen der ausgeschlossenen Standorte abzielen. search_terms: type: array items: type: string example: - pubrio description: >- Eine Liste von Zeichenfolgen, nach denen die Ergebnisse gefiltert werden sollen. headlines: type: array items: type: string example: - ASUS - iPhone description: Eine Liste von Schlagzeilen, mit der Suchergebnisse gefiltert werden. ads_filter_conditions: type: array items: type: object properties: key: type: string enum: - target_locations - exclude_target_locations example: exclude_target_locations description: >- Der Filterschlüssel, der angibt, auf welche Eigenschaft der Operator angewendet wird. operator: type: string enum: - or - and example: or description: >- Der anzuwendende logische Operator. Verwenden Sie „or“, um Anzeigen zu finden, die einen der angegebenen Standorte ein- oder ausschließen, oder „and“, um Anzeigen zu finden, die alle angegebenen Standorte ein- oder ausschließen. description: >- Erweiterte Filteroptionen für Anzeigensuchen. Geben Sie Bedingungen an, um Ihre Suchergebnisse für den Endpunkt zur Anzeigensuche zu verfeinern. start_dates: type: array items: type: string format: date example: - '2025-12-01' - '2025-12-01' description: Eine Liste von Startdaten, mit der Suchergebnisse gefiltert werden. end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Eine Liste von Enddaten, mit der Suchergebnisse gefiltert werden. advertisement_active_dates_search: type: array items: type: string format: date minItems: 2 maxItems: 2 example: - '2026-08-01' - '2026-08-31' description: >- Einschließendes Zeitfenster `[from, to]` (UTC). Gibt Anzeigen zurück, die irgendwann in diesem Zeitraum liefen, einschließlich solcher, die früher begonnen haben, sodass es mit Advertisement Insights übereinstimmt. Nicht datierte Anzeigen zählen ab `created_at`. Beide Daten sind erforderlich, `from` ≤ `to`. search_created_at: type: string format: date-time example: '2026-09-02T12:00:00Z' description: >- Erfasst zu oder nach diesem Zeitpunkt (UTC). Datum oder ISO-Zeitstempel. Für inkrementelle Synchronisierungen übergeben Sie den `created_at`-Wert Ihrer neuesten gespeicherten Zeile. company_locations: type: array items: type: string example: - US - SG - CN description: >- Der Standort des Unternehmenshauptsitzes. Weitere Informationen finden Sie über die Endpunkte `location` im Filters-Tab. companies: type: array items: type: string format: uuid description: >- Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens- und Personensuchvorgänge. advertisement_search_id: type: string format: uuid example: a92643e8-9033-4029-aa65-ef929327cebb description: >- Eine eindeutige Kennung für das Anzeigen-Suchergebnis. Wird verwendet, um auf bestimmte Anzeigen zu verweisen, die vom Endpunkt zur Anzeigensuche zurückgegeben werden. domains: type: array items: type: string example: - pubrio.com description: >- Liste von Unternehmensdomains für Unternehmens- und Personensuchvorgänge. Erhalten wir eine URL wie `www.pubrio.com` oder `https://docs.pubrio.com/`, wandelt das System diese zur Verarbeitung in `pubrio.com` um. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit `http` und enthält `linkedin.com/company/` is_realtime_enrichment: type: boolean default: false example: true description: >- Aktiviert die Echtzeit-Anreicherung für eine einzelne, unternehmensbezogene Abfrage (gefiltert nach `domain_search_id`, `domains` oder `linkedin_urls`). Liefert die erste Suche null Ergebnisse, scrapt der Endpunkt die Quelle, speichert die Datensätze dauerhaft und führt die Suche vor der Antwort erneut aus. Unterliegt einer routenspezifischen Zeitbegrenzung. advertisement_formats: type: array items: type: string enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement example: - image - video description: >- Findet Unternehmen mit mindestens einer Anzeige in einem dieser Creative-Formate. advertisement_reach_tiers: type: array items: type: string enum: - lt_1k - 1k_10k - 10k_50k - 50k_100k - 100k_500k - 500k_1m - 1m_plus example: - 100k_500k - 500k_1m - 1m_plus description: >- Impressionsbereich der Anzeige: `lt_1k`, `1k_10k`, `10k_50k`, `50k_100k`, `100k_500k`, `500k_1m`, `1m_plus`. Anzeigen ohne `total_impressions`-Wert erzielen nie einen Treffer; unbekannte Slugs liefern keine Treffer. advertisement_active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl der derzeit aktiven Anzeigen des Unternehmens, über alle Länder hinweg. Verwenden Sie `null` für eine offene Grenze, z. B. `[1, null]` für „mindestens eine aktive Anzeige“. advertisement_running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl der noch laufenden Anzeigen des Unternehmens (kein Enddatum oder ein Enddatum in der Zukunft). Derzeit nur für LinkedIn-Anzeigen befüllt. advertisement_total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Minimale und maximale Gesamtzahl der jemals erfassten Anzeigen des Unternehmens, über alle Länder hinweg. advertisement_platform_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Minimale und maximale Anzahl unterschiedlicher Anzeigenplattformen (linkedin, facebook, google, tiktok, apple), auf denen das Unternehmen aktiv wirbt. advertisement_format_count: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 2 - null description: >- Minimale und maximale Anzahl unterschiedlicher Anzeigen-Creative-Formate, die das Unternehmen aktiv schaltet. advertisement_impressions_estimate: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- Minimal und maximal geschätzte Anzeigenimpressionen, summiert über alle Länder. Es werden nur Anzeigen mit gemeldetem Impressionsbereich gezählt. advertisement_country_activity: type: object properties: country: type: string example: US description: >- ISO-3166-1-Alpha-2-Ländercode, auf den dieser Filter beschränkt wird. Erforderlich. rank: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - null - 500 description: >- Rang innerhalb dieses Landes nach Anzeigenvolumen. 1 ist der größte Werbetreibende; die Zahl steigt, je geringer das Anzeigenvolumen ist. Verwenden Sie `[null, 500]`, um die 500 größten Werbetreibenden in diesem Land zu finden; verwenden Sie `[500, null]`, um alle ab Rang 500 zu finden. percentile: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 90 - null description: >- Perzentil innerhalb dieses Landes nach Anzeigenvolumen, 0–100. Ein höherer Wert bedeutet ein größerer Werbetreibender. Verwenden Sie `[90, null]` für die obersten 10 % der Werbetreibenden in diesem Land. volume_score: type: array items: type: number nullable: true minItems: 2 maxItems: 2 example: - 0.5 - null description: >- Der zugrunde liegende Anzeigenvolumen-Score von 0 bis 1, aus dem sowohl `rank` als auch `percentile` berechnet werden. active_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl aktiver Anzeigen, beschränkt auf dieses Land. running_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1 - null description: >- Minimale und maximale Anzahl laufender Anzeigen, beschränkt auf dieses Land. Derzeit nur für LinkedIn-Anzeigen befüllt. total_ads: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 10 - null description: >- Minimale und maximale Gesamtzahl der Anzeigen, beschränkt auf dieses Land. impressions: type: array items: type: integer nullable: true minItems: 2 maxItems: 2 example: - 1000 - null description: >- Minimal und maximal geschätzte Impressionen, beschränkt auf dieses Land. required: - country example: country: US rank: - null - 500 description: >- Werbeaktivität für ein bestimmtes Land. `country` ist erforderlich, und mindestens ein weiteres Feld muss gesetzt sein (ein Land allein liefert keine Treffer). Für eine länderübergreifende Gesamtsumme verwenden Sie stattdessen die übergeordneten Filter `advertisement_active_ads` / `advertisement_total_ads` / `advertisement_impressions_estimate`. advertisement_source_types: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - linkedin - facebook description: >- Einzubeziehende Quellen: `linkedin`, `facebook` (`meta` wird akzeptiert), `google`, `tiktok`, `apple`. Unbekannte Werte liefern keine Treffer und werden in `metadata.unsupported_source_types` zurückgemeldet. advertisement_exclude_source_types: type: array items: type: string enum: - linkedin - facebook - google - tiktok - apple example: - apple description: >- Schließt Anzeigen aus, die aus diesen Quellen erfasst wurden. Gleiches Vokabular wie `source_types` (`linkedin`, `facebook`, `google`, `tiktok`, `apple`; `meta` ist ein Alias für `facebook`). Unbekannte Werte werden ignoriert. advertisement_enrichment_mode: type: string enum: - default - latest default: default example: latest description: >- Steuert das Verhalten der Echtzeit-Anreicherung. `default` gibt zurück, was bereits in der Datenbank vorhanden ist, und löst eine Anreicherung nur aus, wenn die Ergebnismenge leer ist und `is_realtime_enrichment` gesetzt ist. `latest` umgeht den Cache und erzwingt bei jedem Aufruf einen erneuten Anreicherungsdurchlauf gegen die aktuellsten Quelldatensätze – es löst die Anreicherung eigenständig aus, ohne dass ein weiteres Flag erforderlich ist. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch die Obergrenze ist — das Limit ist der `max_search_per_page`-Wert Ihres Abonnements, zurückgegeben von [Profile](/de/api-reference/endpoint/profile/profile). Bei Überschreitung wird **HTTP 416** mit dem Code `41676` (oder `41613` bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge. page: type: integer example: 1 default: 1 description: >- Seitenzahl, beginnend bei 1. Die Obergrenze ist der `max_search_page`-Wert Ihres Abonnements (`max_company_search_page` für die Unternehmenssuche), zurückgegeben von [Profile](/de/api-reference/endpoint/profile/profile). Bei Überschreitung wird **HTTP 416** zurückgegeben. is_ascending_order: type: boolean default: false example: false description: >- Sortierrichtung. Ergebnisse werden standardmäßig neueste zuerst zurückgegeben; setzen Sie `true` für älteste zuerst. Dieser Endpunkt kennt kein `sort_by` – der Sortierschlüssel ist fest und in der Endpunktbeschreibung angegeben. advertisement_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - facebook - instagram description: >- Filtert Facebook/Meta-Anzeigen nach der Plattformoberfläche, auf der sie ausgeliefert wurden. Kleinschreibung, Groß-/Kleinschreibung wird nicht unterschieden. Gilt nur für die Quelle `facebook` (andere Quellen sind Einzelplattform-Quellen). advertisement_exclude_publisher_platforms: type: array items: type: string enum: - facebook - instagram - messenger - threads - audience_network example: - audience_network description: >- Schließt Facebook/Meta-Anzeigen aus, die auf diesen Plattformoberflächen ausgeliefert wurden. advertisement_is_include_unlinked_companies: type: boolean default: false example: true description: >- Schließt Anzeigen ein, die noch keinem aufgelösten Unternehmen zugeordnet sind (Rohdaten-Anzeigen, z. B. Betrugs- oder Burner-Page-Anzeigen). Standardmäßig false, wodurch nur unternehmenszugeordnete Anzeigen zurückgegeben werden. advertisement_search_metadata: allOf: - $ref: '#/components/schemas/search_metadata' - type: object properties: applied_source_types: type: array items: type: string description: >- Nur wenn `source_types` gesendet wurde: die Werte, die erkannt und angewendet wurden. unsupported_source_types: type: array items: type: string description: >- Nur wenn `source_types` einen Wert enthielt, der keine bekannte Quelle ist. Diese Werte liefern keine Treffer. coverage_notes: type: array items: type: object properties: source_type: type: string scope: type: string enum: - eea_uk_ch description: >- Hinweise zur Abdeckung der angeforderten Quellen, sofern zutreffend. skipped_source_types: type: array items: type: object properties: source_type: type: string description: Quelle, die übersprungen wurde. reason: type: string enum: - country_unknown_until_enriched description: Warum die Quelle nicht angewendet wurde. description: >- Quellen, die für die angeforderten `target_locations` nicht angewendet wurden, jeweils mit einer `reason`. description: Anfragekontext. search_pagination: type: object description: Paginierung für die Ergebnismenge. properties: page: type: integer description: Aktuelle Seitenzahl. per_page: type: integer description: Datensätze pro Seite. total_entries: type: integer description: >- Gesamtzahl der passenden Datensätze. Bei breiten, unternehmensunabhängigen Suchen handelt es sich um eine Schätzung. total_pages: type: integer description: '`total_entries` geteilt durch `per_page`.' total_display_pages: type: integer description: >- Seiten, die Sie tatsächlich anfordern können, begrenzt durch `max_search_page` Ihres Tarifs. is_timeout: type: boolean description: >- `true`, wenn die Zählabfrage ein Timeout hatte und `total_entries` eine teilweise Schätzung ist. advertisement_search_result: type: object description: Eine Anzeige. properties: advertisement_id: type: string format: uuid description: Anzeigenkennung. advertisement_search_id: type: string format: uuid description: >- Derselbe Wert wie `advertisement_id`. Übergeben Sie ihn an Advertisement Lookup. created_at: type: string format: date-time description: >- Wann Pubrio die Anzeige erstmals erfasst hat. Dies ist der Standard-Sortierschlüssel. last_modified: type: string format: date-time description: Wann der Datensatz zuletzt aktualisiert wurde. started_at: type: string format: date-time description: Wann die Anzeige zu laufen begann, wie von der Quelle gemeldet. nullable: true ended_at: type: string format: date-time description: Wann die Anzeige nicht mehr lief; `null`, solange sie noch läuft. nullable: true title: type: string description: Schlagzeile oder Anzeigentitel. nullable: true source_type: type: string enum: - linkedin - facebook - google - tiktok - apple description: >- Quelle, aus der die Anzeige erfasst wurde. Gleiches Vokabular wie der Filter `source_types`. advertisement_format: type: string description: >- Formatbezeichnung genau so, wie die Quelle sie veröffentlicht, z. B. `Single Image Ad`, `MULTI_IMAGES`. nullable: true advertisement_format_normalized: type: string nullable: true enum: - image - video - text - carousel - dynamic_product - document - message - event - article - spotlight - follow - job - engagement - other description: >- Kanonisches Format, das Vokabular, das der Filter `advertisement_formats` akzeptiert. `other`, wenn die Rohbezeichnung nicht zugeordnet ist. is_company_matched: type: boolean description: >- `true`, wenn die Anzeige mit einem Pubrio-Unternehmensdatensatz verknüpft ist. Nicht verknüpfte Anzeigen werden nur mit `is_include_unlinked_companies: true` zurückgegeben. advertiser: type: string description: Name des Werbetreibenden wie von der Quelle angezeigt. nullable: true advertiser_url: type: string description: Werbetreibenden-Seite bei der Quelle, sofern verfügbar. nullable: true advertisement_url: type: string description: >- Link zur Anzeige in der Anzeigenbibliothek der Quelle, sofern verfügbar. nullable: true total_impressions: type: string description: >- Geschätzte Impressionen genau so, wie die Quelle sie veröffentlicht, z. B. `< 1k`, `10k-50k`. `null` bei Quellen, die keine Impressionen melden. nullable: true total_impressions_lower: type: integer nullable: true description: Untere Grenze des Impressionsbereichs; `null` bei `< N`-Bereichen. total_impressions_upper: type: integer nullable: true description: Obere Grenze des Impressionsbereichs; `null` bei offenen Bereichen. image_url: type: string description: Creative-Bild, sofern die Anzeige eines hat. nullable: true video_url: type: string description: Creative-Video, sofern die Anzeige eines hat. nullable: true carousel_images: type: array nullable: true items: type: string description: Karussell-Frames, für Karussell-Formate. destination_url: type: string description: >- Aufgelöste Landingpage. Facebook-Click-Wrapper wie `fb.me` werden zur tatsächlichen Funnel-URL aufgelöst. nullable: true raw_link_url: type: string description: Der ursprüngliche Link genau so erfasst, vor der Auflösung. nullable: true target_country_codes: type: array nullable: true items: type: string description: >- Länder, in denen die Anzeige gezeigt wurde (ISO 3166-1 Alpha-2). Gleiches Vokabular wie der Filter `target_locations`. publisher_platforms: type: array nullable: true items: type: string enum: - facebook - instagram - messenger - threads - audience_network description: >- Meta-Oberflächen, auf denen die Anzeige lief: `facebook`, `instagram`, `messenger`, `threads`, `audience_network`. `null` bei Quellen außer `facebook`. companies: $ref: '#/components/schemas/search_result_company' search_metadata: type: object description: Anfragekontext. properties: profile: type: object nullable: true description: >- Credit-Block (`credit`, `topup_credit`, `total_credit_cost`), wenn eine Credit-Abrechnung angefordert wird; `null` bei reinem API-Key-Traffic. filters: type: object description: >- Rückgabe des Request-Bodys so, wie der Endpunkt ihn angewendet hat, einschließlich Standardwerten wie `per_page` und `language`. ignored_fields: type: array items: type: string description: >- Body-Schlüssel, die der Endpunkt nicht erkannt und verworfen hat. Leer bedeutet, dass jeder Schlüssel angewendet wurde – ein falsch geschriebener Filter erweitert die Suche, statt fehlzuschlagen. search_result_company: type: object description: Das Unternehmen, mit dem der Datensatz verknüpft ist. properties: domain_search_id: type: string format: uuid description: >- Pubrio-Unternehmenskennung. Übergeben Sie sie an `companies` bei jeder Suche oder an Company Lookup. company_name: type: string description: Unternehmensname. linkedin_name: type: string nullable: true description: LinkedIn-Unternehmens-Slug (der Teil nach `linkedin.com/company/`). country_code: type: string nullable: true description: ISO-3166-1-Alpha-2-Code des Unternehmenshauptsitzes. company_url: type: string nullable: true description: URL der Unternehmenswebsite. domain: type: string description: Unternehmensdomain, normalisiert (`stripe.com`). logo_url: type: string nullable: true description: URL des Unternehmenslogos. 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 ````