> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta-Werbebibliothek API

> Durchsuchen Sie die Meta-Werbebibliothek nach Stichwort oder Werbetreibendem und erhalten Sie die Anzeigen, die auf Facebook, Instagram, Messenger, WhatsApp und Threads laufen, als JSON mit Text, Medien, Zielseite und Plattformen.

Durchsuchen Sie die Meta-Werbebibliothek über die asynchrone Task-API und erhalten Sie JSON. Senden Sie `taskType` `ADS` mit `platform` `meta_ad_library` und einem Stichwort in `query` oder der Facebook-Seiten-ID eines Werbetreibenden in `pageId`. Eine Suche kostet **0.5 Credits je 30 gelieferte Anzeigen**. Um die Seiten-ID eines Werbetreibenden über seinen Namen zu finden, senden Sie `action` `advertisers`.

## Anfrage

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "meta_ad_library", "pageId": "266556540473351", "country": "US" } }'
```

Senden Sie den Task und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md). Eine Suche nach 30 Anzeigen ist meist in wenigen Sekunden fertig, eine Suche nach 500 Anzeigen in etwa einer Minute.

## Parameter

* `action`: `search` (Standard) oder `advertisers`, das Werbetreibende über ihren Namen findet.
* `query`: Ein Stichwort. Es findet die Wörter im Text einer Anzeige in beliebiger Reihenfolge. Erforderlich, wenn `pageId` fehlt.
* `pageId`: Die numerische Facebook-Seiten-ID eines Werbetreibenden, etwa `266556540473351`. Sie listet seine Anzeigen und durchsucht sie zusammen mit `query`.
* `country`: Wo die Anzeigen liefen, als zweistelliger Ländercode, oder `ALL` für alle Länder. Standard ist `US`.
* `activeStatus`: `active` (Standard), `inactive` oder `all`.
* `limit`: 1 bis 500 Anzeigen. Standard ist 30.
* `cursor`: Der `nextCursor` einer früheren Antwort, um die folgenden Anzeigen zu lesen.
* `searchType`: `keyword_unordered` (Standard) oder `keyword_exact_phrase`.
* `adType`: `all` (Standard), `political_and_issue_ads`, `housing_ads`, `employment_ads` oder `financial_products_and_services_ads`.
* `mediaType`: `all` (Standard), `image`, `meme`, `image_and_meme`, `video` oder `none`.
* `publisherPlatforms`: Einer oder mehrere von `facebook`, `instagram`, `audience_network`, `messenger`, `whatsapp` und `threads`, als Array oder kommagetrennter Text.
* `contentLanguages`: Ein oder mehrere zweistellige Sprachcodes.
* `startDate`, `endDate`: `YYYY-MM-DD`. Behält die Anzeigen, die zwischen den beiden Tagen gezeigt wurden.
* `sortBy`: `impressions_high_to_low` (Standard) oder `most_recent`. `impressions_low_to_high` setzt `adType` `political_and_issue_ads` voraus, die einzigen Anzeigen, die die Bibliothek so sortiert.

Ein Wert, den die Bibliothek nicht durchsuchen kann, wird mit `400 VALIDATION_ERROR` abgelehnt, und `details` nennt das Feld.

## Weitere Anzeigen lesen

Eine Antwort, nach der noch Anzeigen zu lesen sind, enthält `nextCursor`. Senden Sie ihn als `cursor` mit derselben Suche, um die nächsten Anzeigen zu erhalten, wieder bis zu `limit`. Die Positionen setzen die vorige Antwort fort, und `nextCursor` ist `null`, sobald die Bibliothek keine weiteren hat.

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "meta_ad_library", "pageId": "266556540473351", "country": "US", "limit": 500, "cursor": "<nextCursor>" } }'
```

Ein Cursor gilt nur für die Suche, die ihn geliefert hat: Eine andere `query`, `pageId`, `country`, `activeStatus` oder ein anderer Filter wird mit `400 VALIDATION_ERROR` abgelehnt, `limit` darf sich ändern. Der Cursor wächst mit den zuvor gelesenen Anzeigen, nach tausend Anzeigen auf etwa 14 KB; speichern Sie ihn als Text ohne Längenbegrenzung. Die Bibliothek listet eine Anzeige manchmal zweimal, daher kann eine Anzeige in einer späteren Antwort erneut erscheinen; `libraryId` unterscheidet die Wiederholungen.

## Werbetreibende finden

`action` `advertisers` liefert die Facebook-Seiten der Werbetreibenden, deren Name zu `query` passt, so wie das Suchfeld der Bibliothek sie vorschlägt. Senden Sie die gewählte `pageId`, um die Anzeigen dieses Werbetreibenden zu durchsuchen.

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "meta_ad_library", "action": "advertisers", "query": "soundcore", "country": "US" } }'
```

```json theme={"theme":"css-variables"}
{
  "platform": "meta_ad_library",
  "action": "advertisers",
  "country": "US",
  "query": "soundcore",
  "returnedCount": 15,
  "advertisers": [
    {
      "position": 1,
      "pageId": "266556540473351",
      "name": "soundcore",
      "category": "Electronics",
      "likeCount": 147916,
      "verified": true,
      "country": null,
      "pageAlias": "soundcoreaudio",
      "profileUrl": "https://www.facebook.com/soundcoreaudio",
      "pictureUrl": "https://scontent-icn2-1.xx.fbcdn.net/v/t39.30808-1/793212698_1136613785698308_1883143393953135850_n.jpg",
      "instagramUsername": "soundcoreaudio",
      "instagramFollowerCount": 154040,
      "instagramVerified": true,
      "libraryUrl": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=266556540473351"
    }
  ],
  "keywords": []
}
```

Jeder Werbetreibende hat `position`, `pageId`, `name`, `category`, `likeCount`, `verified` (Metas blaues Abzeichen), `country` (das Land der Seite, wenn Meta es nennt, etwa die britische Seite einer globalen Marke), `pageAlias`, `profileUrl`, `pictureUrl`, `instagramUsername`, `instagramFollowerCount`, `instagramVerified` und `libraryUrl`, das seine Anzeigen in der Werbebibliothek öffnet. `keywords` listet die Suchen, die die Bibliothek für den Namen vorschlägt. Die Bibliothek sucht den Namen so, wie die Seite ihn schreibt: `Shokz` findet die Shokz-Seiten, `샥즈` findet keine. Ein Name, den keine Seite trägt, endet mit leerem `advertisers`. Eine Suche nach Werbetreibenden nimmt nur `query` und `country` und kostet 0.5 Credits.

## Antwortbeispiel

```json theme={"theme":"css-variables"}
{
  "platform": "meta_ad_library",
  "action": "search",
  "country": "US",
  "pageId": "266556540473351",
  "activeStatus": "active",
  "totalCount": 849,
  "returnedCount": 30,
  "hasMore": true,
  "nextCursor": "eyJ2IjoxLCJoIjoiMnhZaDJ3VVhxdGNKRXBaOSIsImMiOiJBUUhUaWVMOXYweDloLXhIYzdQV1BYSGxNcE9rcUthVVMxNnUydTNxYWpJN2FBd2lOYW8tQ0lNWm16bDE4endJcFBWViIsInMiOjAsInAiOjMwfQ",
  "libraryUrl": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&media_type=all&search_type=page&view_all_page_id=266556540473351",
  "ads": [
    {
      "position": 1,
      "libraryId": "2033461067351971",
      "libraryUrl": "https://www.facebook.com/ads/library/?id=2033461067351971",
      "pageId": "266556540473351",
      "pageName": "soundcore",
      "pageProfileUrl": "https://www.facebook.com/soundcoreaudio/",
      "pageLikeCount": 147918,
      "pageCategories": ["Electronics"],
      "isActive": true,
      "startDate": "2026-11-14",
      "endDate": "2026-11-19",
      "platforms": ["FACEBOOK", "INSTAGRAM"],
      "versions": 5,
      "format": "DCO",
      "body": "🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.",
      "title": "AeroClip 2 Open-Ear",
      "caption": "soundcore.com",
      "linkUrl": "https://www.soundcore.com/aeroclip-2-best-clear-calls-clip-on-open-earbuds-boa",
      "linkDescription": "Four colors, match.",
      "ctaText": "Shop now",
      "ctaType": "SHOP_NOW",
      "images": [],
      "videos": [],
      "cards": [
        {
          "title": "Made to Match",
          "body": "🍎Four finishes made to match. AeroClip 2, the first open-ear clip-on with Apple MFi certification.",
          "linkUrl": "https://www.soundcore.com/aeroclip-2-best-clear-calls-clip-on-open-earbuds-boa",
          "linkDescription": "Four colors, match.",
          "ctaText": "Shop Now",
          "ctaType": "SHOP_NOW",
          "imageUrl": "https://scontent-dfw6-2.xx.fbcdn.net/v/t39.35426-6/897874467_980515998005271_8997541605873239828_n.jpg"
        }
      ]
    }
  ]
}
```

## Ergebnisfelder

* Die Antwort wiederholt `platform`, `action`, `country`, `query` oder `pageId`, `activeStatus` und die übergebenen Filter.
* `totalCount` ist die Zahl der passenden Anzeigen laut Bibliothek, die sie bei großen Suchen rundet. `returnedCount` zählt die Anzeigen in `ads`, `hasMore` ist `true`, wenn die Bibliothek weitere hat, die `nextCursor` liest, und `libraryUrl` öffnet dieselbe Suche in der Werbebibliothek.
* Jede Anzeige hat `position`, `libraryId`, `libraryUrl`, `isActive`, `startDate` und `endDate` (Tage in UTC), `platforms`, `versions` (wie viele Anzeigen dieses Creative und diesen Text nutzen), `format` (`IMAGE`, `VIDEO`, `CAROUSEL`, `DCO`, `DPA`, `MULTI_IMAGES` und andere), `body`, `title`, `caption`, `linkUrl`, `linkDescription`, `ctaText`, `ctaType` und `categories` (die Kategorien der Anzeige laut Bibliothek, etwa `POLITICAL` oder `EMPLOYMENT`).
* Der Werbetreibende ist `pageId`, `pageName`, `pageProfileUrl`, `pageProfilePictureUrl`, `pageLikeCount` und `pageCategories`. Anzeigen zu gesellschaftlichen Themen, Wahlen oder Politik ergänzen `byline`, wer die Anzeige bezahlt hat, und `disclaimerLabel`, und eine bezahlte Partnerschaft ergänzt die Seite des Partners in `brandedContent`.
* Medien sind `images` (`url`, `resizedUrl`), `videos` (`hdUrl`, `sdUrl`, `previewImageUrl`) und `cards`, die Karten einer Karussell- oder Katalog-Anzeige, jeweils mit `title`, `body`, `linkUrl`, `caption`, `linkDescription`, `ctaText`, `ctaType`, `imageUrl`, `resizedImageUrl` und `video`. Die weiteren Texte, Links, Bilder und Videos einer dynamischen Anzeige stehen in `extraTexts`, `extraLinks`, `extraImages` und `extraVideos`.
* Medien-URLs sind Links auf Metas CDN, die nach einigen Tagen ablaufen. Speichern Sie die Dateien, die Sie brauchen.
* Katalog-Anzeigen (`DPA`, `DCO`) behalten in ihrem Text die Platzhalter der Bibliothek, etwa `{{product.name}}`.
* `spend`, `currency`, `impressions` und `reach` erscheinen nur, wo die Bibliothek sie offenlegt: bei Anzeigen zu gesellschaftlichen Themen, Wahlen oder Politik und bei Anzeigen, die in der EU gezeigt wurden.
* Eine Suche ohne passende Anzeigen wird mit leerem `ads` und `totalCount` `0` abgeschlossen.

## Preis

Eine Suche reserviert beim Start 0.5 Credits je 30 Anzeigen, die `limit` anfragt, und kostet 0.5 Credits je 30 gelieferte Anzeigen, mindestens 0.5 Credits. Die Standardsuche nach 30 Anzeigen kostet 0.5 Credits, eine Suche mit `limit` 500 reserviert 8.5 Credits. Eine Suche nach Werbetreibenden kostet 0.5 Credits. Berechnet werden nur abgeschlossene Anfragen.

## Siehe auch

* [Instagram](https://docs.querying.ai/de/engines/instagram.md)
* [Threads](https://docs.querying.ai/de/engines/threads.md)
* [Engine-Übersicht](https://docs.querying.ai/de/engines/overview.md)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.