Anzeigensuche

Advertisement Search liefert einzelne von Pubrio erfasste Anzeigen zurück, eine Zeile pro Anzeige. Jede Zeile enthält das Creative (Überschrift, Bild oder Video, Landingpage), wo sie gezeigt wurde, wann sie lief, und die von der Quelle gemeldete Impressionsspanne.

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "source_types": ["linkedin", "facebook"],
    "active_dates": ["2026-08-01", "2026-08-31"],
    "per_page": 25
  }'

Wann verwenden

Wettbewerbsrecherche zu Creatives — was ein Wettbewerber kommuniziert, in welchen Ländern, in welchem Format.
Intent — ein Unternehmen, das gerade begonnen hat, in einem neuen Markt zu werben, expandiert dorthin. Kombinieren Sie dies mit target_locations.
Ausgaben-Proxys — reach_tiers und die advertisement_*-Metrikfilter ordnen Unternehmen nach Werbevolumen ein, ohne einen konkreten Ausgabenwert.

Für Summen und Trends verwenden Sie Advertisement Insights. Um Unternehmen anhand ihrer Werbung statt der Anzeigen selbst zu finden, verwenden Sie die advertisement_*-Filter bei Company Search.

Quellen

`source_type`	Hinweise
`linkedin`	Umfangreiche Formatlabels (`Single Image Ad`, `Document Ad`, …)
`facebook`	Umfasst Facebook, Instagram, Messenger, Threads und Audience Network; mit `publisher_platforms` eingrenzen. `meta` wird als Alias akzeptiert.
`google`	Meist `text`
`tiktok`
`apple`

total_impressions ist null bei Anzeigen, deren Quelle keine Schätzung veröffentlicht, und solche Anzeigen treffen nie auf reach_tiers zu.

Auf ein Unternehmen eingrenzen

Schlüssel	Wert
`domains`	`["stripe.com"]`
`linkedin_urls`	`["https://www.linkedin.com/company/stripe"]`
`companies`	`["5378845d-…"]` — `domain_search_id`-Werte

Eine Suche ohne Unternehmen ist erlaubt, zum Beispiel {"target_locations": ["SG"], "source_types": ["linkedin"]}. Es werden nur bereits mit einem Pubrio-Unternehmen verknüpfte Anzeigen zurückgegeben, sofern Sie nicht is_include_unlinked_companies: true setzen.

Filter

Quelle und Format

Schlüssel	Typ	Trifft zu auf
`source_types`	`string[]`	`linkedin`, `facebook`, `google`, `tiktok`, `apple`. Beliebiger aufgeführter Wert. Unbekannte Werte treffen auf nichts zu und werden in `metadata.unsupported_source_types` wiedergegeben.
`exclude_source_types`	`string[]`	Dasselbe Vokabular, ausgeschlossen.
`advertisement_formats`	`string[]`	Kanonische Formate: `image`, `video`, `text`, `carousel`, `dynamic_product`, `document`, `message`, `event`, `article`, `spotlight`, `follow`, `job`, `engagement`. Siehe Formate.
`publisher_platforms` / `exclude_publisher_platforms`	`string[]`	`facebook`, `instagram`, `messenger`, `threads`, `audience_network`. Nur Meta-Anzeigen.

Text

Schlüssel	Typ	Trifft zu auf
`headlines`	`string[]`	Überschriftentext, beliebiger aufgeführter Wert.
`search_term` / `search_terms`	`string` / `string[]`	Überschrift und Beschreibung.

Daten

Schlüssel	Typ	Trifft zu auf
`active_dates`	`[von, bis]`	Anzeigen, die zu einem beliebigen Zeitpunkt im Fenster liefen, einschließlich Anzeigen, die früher gestartet sind und noch laufen. Dies ist das Fenster, das Advertisement Insights verwendet. Anzeigen ohne `started_at` zählen ab `created_at`. Beide Daten erforderlich; UTC-Tagesgrenzen.
`start_dates`	`[von, bis]`	`started_at` innerhalb des Fensters — Anzeigen, die dann gestartet wurden. Tagesgrenzen richten sich nach der Workspace-Zeitzone.
`end_dates`	`[von, bis]`	`ended_at` innerhalb des Fensters. Tagesgrenzen richten sich nach der Workspace-Zeitzone.
`created_at`	Datum oder ISO-Zeitstempel	Von Pubrio zu diesem Zeitpunkt oder danach erfasst (UTC), für inkrementelle Synchronisierung.

start_dates verbirgt die meisten laufenden Kampagnen eines Unternehmens, da eine im März gestartete Kampagne im August noch läuft. Greifen Sie zu active_dates, sofern Sie nicht speziell Starts suchen.

Wo sie gezeigt wurde

Schlüssel	Typ	Trifft zu auf
`target_locations`	`string[]`	Länder, in denen die Anzeige ausgeliefert wurde. Standardmäßig OR; fügen Sie `{"key": "target_locations", "operator": "and"}` zu `filter_conditions` hinzu, um jedes Land zu verlangen.
`exclude_target_locations`	`string[]`	Auszuschließende Länder.
`company_locations`	`string[]`	Sitzland des Werbetreibenden.

Reichweite und Volumen

Schlüssel	Typ	Trifft zu auf
`reach_tiers`	`string[]`	Impressionsband der Anzeige: `lt_1k`, `1k_10k`, `10k_50k`, `50k_100k`, `100k_500k`, `500k_1m`, `1m_plus`. Anzeigen ohne `total_impressions`-Wert treffen nie zu.
`advertisement_active_ads`, `advertisement_running_ads`, `advertisement_total_ads`, `advertisement_platform_count`, `advertisement_format_count`, `advertisement_impressions_estimate`	`[min, max]`	Filtert Anzeigen nach den Gesamtwerten des Werbetreibenden, z. B. liefert `advertisement_active_ads: [10, null]` Anzeigen von Unternehmen mit mindestens zehn laufenden Anzeigen.
`advertisement_country_activity`	Objekt	`{ "country": "US", "rank": [null, 100] }` — Anzeigen der Top-100-Werbetreibenden in diesem Land.

Anreicherung

Schlüssel	Typ	Hinweise
`is_realtime_enrichment`	`boolean`	Wenn die Suche nichts liefert, die Quellen jetzt scrapen und erneut suchen. Nur bei unternehmensbezogenen Suchen.
`enrichment_mode`	`default` / `latest`	`latest` scraped bei jedem Aufruf neu, unabhängig vom Cache.
`is_include_unlinked_companies`	`boolean`	Gibt auch Anzeigen zurück, die Pubrio keinem Unternehmensdatensatz zuordnen konnte (`is_company_matched: false`).

Paginierung und Reihenfolge

per_page, page und is_ascending_order verhalten sich wie bei jeder Suche. Zeilen werden nach created_at (Erfassungszeit) sortiert, neueste zuerst.

So sieht eine Zeile aus

{
  "advertisement_id": "58fa840e-08aa-4ac8-a204-8b185fd62f8e",
  "advertisement_search_id": "58fa840e-08aa-4ac8-a204-8b185fd62f8e",
  "created_at": "2026-09-01T02:00:07.068Z",
  "last_modified": "2026-09-01T02:00:07.068Z",
  "started_at": "2026-08-24T00:00:00.000Z",
  "ended_at": "2026-08-31T00:00:00.000Z",
  "title": "Your 2026 peak season prep checklist is here",
  "source_type": "linkedin",
  "advertisement_format": "Single Image Ad",
  "advertisement_format_normalized": "image",
  "is_company_matched": true,
  "advertiser": "Stripe",
  "advertiser_url": "https://www.linkedin.com/company/2135371",
  "advertisement_url": "https://www.linkedin.com/ad-library/detail/1518455034",
  "total_impressions": "< 1k",
  "total_impressions_lower": null,
  "total_impressions_upper": 1000,
  "image_url": "https://buckets.pubrio.com/images/public/….jpg",
  "video_url": null,
  "carousel_images": null,
  "destination_url": "https://stripe.com/industries/retail?trk=…",
  "raw_link_url": null,
  "target_country_codes": ["US"],
  "publisher_platforms": null,
  "companies": {
    "domain_search_id": "5378845d-7726-4817-aba9-ced8c5f41dee",
    "company_name": "Stripe",
    "domain": "stripe.com",
    "country_code": "US",
    "…": "…"
  }
}

ended_at ist null, während die Anzeige noch läuft.
advertisement_format ist das eigene Label der Quelle; advertisement_format_normalized ist der Slug, nach dem Sie filtern können.
destination_url ist die entpackte Landingpage; raw_link_url behält den Click-Tracker exakt wie erfasst bei.
total_impressions ist der Text der Quelle; das Paar _lower / _upper ist der geparste Bereich.

`metadata` bei diesem Endpunkt

"metadata": {
  "profile": null,
  "filters": { "domains": ["stripe.com"], "source_types": ["tiktok", "bogus"], "per_page": 25, "language": "en" },
  "ignored_fields": [],
  "applied_source_types": ["tiktok"],
  "unsupported_source_types": ["bogus"],
  "coverage_notes": [{ "source_type": "tiktok", "scope": "eea_uk_ch" }]
}

Schlüssel	Wann vorhanden	Bedeutung
`ignored_fields`	Immer	Body-Schlüssel, die der Endpunkt verworfen hat
`applied_source_types`	`source_types` gesendet	Werte, die erkannt wurden
`unsupported_source_types`	Unbekannter Wert gesendet	Diese Werte trafen auf nichts zu
`coverage_notes`	Falls zutreffend	Abdeckungshinweise für die angefragten Quellen
`skipped_source_types`	Falls zutreffend	`[{ "source_type", "reason" }]` — Quellen, die für die angefragten `target_locations` nicht angewendet wurden

Rezepte

Wettbewerber-Creatives in einem Markt
LinkedIn-Anzeigen mit hoher Reichweite
Nur Instagram bei Meta-Anzeigen

cURL

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["adyen.com", "checkout.com"],
    "target_locations": ["SG", "AU"],
    "advertisement_formats": ["video", "carousel"],
    "active_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'

cURL

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_locations": ["US"],
    "source_types": ["linkedin"],
    "reach_tiers": ["100k_500k", "500k_1m", "1m_plus"],
    "active_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'

companies.domain_search_id jeder Zeile ist ein Unternehmen, das diesen Monat stark auf LinkedIn in den USA wirbt.

cURL

curl -X POST https://api.pubrio.com/companies/advertisements/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["nike.com"],
    "source_types": ["facebook"],
    "publisher_platforms": ["instagram"],
    "exclude_publisher_platforms": ["facebook"],
    "per_page": 25
  }'

Siehe auch

Advertisement Search reference

Jeder Parameter und jedes Antwortfeld.

Advertisement Insights

Summen, Reichweiten-Stufen und Creatives für ein Unternehmen über ein Zeitfenster.

Filter für Werbeaktivität

Unternehmen anhand ihrer Werbung bei Company Search finden.

Enums & Konstanten

Quellen, Formate, Plattformen und Reichweiten-Stufen.

Monitore

Suche

Filter

Personen

Expansion

Wann verwenden

Quellen

Auf ein Unternehmen eingrenzen

Filter

Quelle und Format

Text

Daten

Wo sie gezeigt wurde

Reichweite und Volumen

Anreicherung

Paginierung und Reihenfolge

So sieht eine Zeile aus

`metadata` bei diesem Endpunkt

Rezepte

Siehe auch

Advertisement Search reference

Advertisement Insights

Filter für Werbeaktivität

Enums & Konstanten

​Wann verwenden

​Quellen

​Auf ein Unternehmen eingrenzen

​Filter

​Quelle und Format

​Text

​Daten

​Wo sie gezeigt wurde

​Reichweite und Volumen

​Anreicherung

​Paginierung und Reihenfolge

​So sieht eine Zeile aus

​metadata bei diesem Endpunkt

​Rezepte

​Siehe auch

Advertisement Search reference

Advertisement Insights

Filter für Werbeaktivität

Enums & Konstanten

Wann verwenden

Quellen

Auf ein Unternehmen eingrenzen

Filter

Quelle und Format

Text

Daten

Wo sie gezeigt wurde

Reichweite und Volumen

Anreicherung

Paginierung und Reihenfolge

So sieht eine Zeile aus

`metadata` bei diesem Endpunkt

Rezepte

Siehe auch