> ## 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.
# Anzeigensuche
> Finden Sie die Anzeigen, die ein Unternehmen auf LinkedIn, Meta, Google, TikTok und Apple schaltet — nach Quelle, Format, Zielland, Reichweite und aktivem Zeitraum — und lesen Sie das Creative, die Landingpage und die Impressionsdaten zu jeder einzelnen.
[Advertisement Search](/de/api-reference/endpoint/companies/advertisements_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.
```bash theme={null}
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](/de/api-reference/endpoint/companies/advertisements_insights). Um *Unternehmen* anhand ihrer Werbung statt der Anzeigen selbst zu finden, verwenden Sie die `advertisement_*`-Filter bei [Company Search](/de/api-reference/endpoint/companies/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](/de/api-reference/enums#formats). |
| `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
```json theme={null}
{
"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
```json theme={null}
"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
```bash cURL theme={null}
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
}'
```
```bash cURL theme={null}
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.
```bash cURL theme={null}
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
Jeder Parameter und jedes Antwortfeld.
Summen, Reichweiten-Stufen und Creatives für ein Unternehmen über ein Zeitfenster.
Unternehmen anhand ihrer Werbung bei Company Search finden.
Quellen, Formate, Plattformen und Reichweiten-Stufen.