Facebook-API

Facebook-Anzeigensuche-API

Durchsuche die Meta Ad Library per Keyword und erhalte passende Anzeigen (Werbetreibender, Creative-Text, CTA, Plattformen und Laufzeiten) mit Cursor-Paginierung.

1,05 USD/1k Anfr., Zahlung pro Anfrage, kein Abo.

fMeta Ad Library
facebook.com/ads/library/?q=protein%20powder
Meta
United StatesiAll adsprotein powder

~214 results

Vantage Nutrition

Active · Sponsored

20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.

photo

vantagenutrition.com

Subscribe and save 20%. Cancel anytime.

Shop Now
Library ID: 705513298640217FBIG

PureForm Labs

Active · Sponsored

Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.

video

pureformlabs.com

Free shipping on orders over $40.

Learn More
Library ID: 592047718834105FBIGMSG
Was die API zurückgegeben hatads[0]
{
"id": "705513298640217",
"sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
"pageId": "398201744920331",
"pageName": "Vantage Nutrition",
"active": true,
"startDate": 1756512000,
"endDate": 1758758400,
"text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
... 18 weitere Felder
}
Verfügbarkeit
99,92%
30d · 335.380 Aufrufe
Anfragen
335.455
30 T · wöchentlich, letzte 12 Wochen
Antwort
1,7s
Median · 30d

Preise und Anbieter

Preise der Facebook-Anzeigensuche-API: eine API, 5 austauschbare Anbieter

Der günstigste Anbieter bedient zuerst. Fällt er aus, übernimmt der nächste im selben Aufruf.

Du zahlst
10,50 USD
1,05 USD/1k Anfr., nur für das, was du nutzt. Kein Monatstarif.
Deine ersten 95 Anfragen sind mit dem Startguthaben von 0,10 USD kostenlos.

Ausprobieren

Facebook Anzeigensuche mit einer Anfrage abrufen

requireFieldsarray
Optional; wenn weggelassen, bleibt das Routing unverändert, und die günstigste Quelle bedient. Nenne die Ausgabefelder, die diese Anfrage zurückgeben können muss, zum Beispiel `totalResults`, und sie wird nur von einer Quelle bedient, die jedes davon zurückgibt. Felder, die du nicht nennst, werden weiterhin zurückgegeben, sobald die bedienende Quelle sie hat. Das kann deinen Preis erhöhen: Wenn die günstigste Quelle ein genanntes Feld nicht zurückgeben kann, bedient eine teurere Quelle, und dir wird ihr Preis genannt und berechnet. Ein genanntes Feld kann bei einer Anzeige, die es tatsächlich nicht hat, trotzdem fehlen. Eine Kombination zu nennen, die keine einzelne Quelle zusammen zurückgibt, wird als ungültige Eingabe ohne Berechnung abgelehnt.
Öffnen in
Beispielantwort
Kostenlose Läufe liefern nur die ersten 3 Ergebnisse. Lade einen Schlüssel auf, um die vollständige Antwort zu bekommen.

Dieses Beispiel zeigt 35 von 46 Feldern. Alle Felder ansehen

{
  "found": true,
  "data": {
    "totalResults": 214,
    "nextCursor": "AQHRZ9d3f2k7m1x8c",
    "ads": [
      {
        "id": "705513298640217",
        "sourceUrl": "https://www.facebook.com/ads/library/?id=705513298640217",
        "pageId": "398201744920331",
        "pageName": "Vantage Nutrition",
        "active": true,
        "startDate": 1756512000,
        "endDate": 1758758400,
        "text": "20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.",
        "title": "Protein that doesn't taste like chalk",
        "ctaText": "Shop Now",
        "ctaType": "SHOP_NOW",
        "linkUrl": "https://vantagenutrition.com/protein",
        "displayFormat": "IMAGE",
        "platforms": [
          "facebook",
          "instagram"
        ],
        "adCount": 3,
        "pageProfilePicture": "https://scontent.fbcdn.net/vantage-profile.jpg",
        "media": [
          {
            "type": "photo",
            "url": "https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg",
            "width": 1080,
            "height": 1080
          }
        ],
        "caption": "vantagenutrition.com",
        "linkDescription": "Subscribe and save 20%. Cancel anytime.",
        "pageUrl": "https://www.facebook.com/vantagenutrition",
        "pageCategories": [
          "Product/service",
          "Health/beauty"
        ],
        "pageLikes": 61300,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ]
      },
      {
        "id": "592047718834105",
        "sourceUrl": "https://www.facebook.com/ads/library/?id=592047718834105",
        "pageId": "711029384710556",
        "pageName": "PureForm Labs",
        "active": true,
        "startDate": 1757203200,
        "endDate": 1759363200,
        "text": "Plant based protein powder with 25g per scoop and no bloating. Third party tested, banned substance free.",
        "title": "25g of plant protein, zero bloat",
        "ctaText": "Learn More",
        "ctaType": "LEARN_MORE",
        "linkUrl": "https://pureformlabs.com/plant-protein",
        "displayFormat": "VIDEO",
        "platforms": [
          "facebook",
          "instagram",
          "messenger"
        ],
        "adCount": 1,
        "pageProfilePicture": "https://scontent.fbcdn.net/pureform-profile.jpg",
        "media": [
          {
            "type": "video",
            "url": "https://scontent.xx.fbcdn.net/v/t42.1790-2/pureform-protein-poster.jpg",
            "videoUrl": "https://video.xx.fbcdn.net/v/t42.9040-2/pureform-protein-ad.mp4",
            "width": 1080,
            "height": 1350
          }
        ],
        "caption": "pureformlabs.com",
        "linkDescription": "Free shipping on orders over $40.",
        "pageUrl": "https://www.facebook.com/pureformlabs",
        "pageCategories": [
          "Product/service",
          "Health/beauty"
        ],
        "pageLikes": 18900,
        "isReshared": false,
        "pageDeleted": false,
        "categories": [
          "Uncategorized"
        ]
      }
    ]
  }
}

Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.

Referenz

Eine Anfrage, eine Antwortstruktur.

Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.

Zuletzt geprüft 2026-11-21 · Verfügbarkeit und Latenz gemessen über 30d

Request-Body

JSON, per POST an diesen Endpoint gesendet.

  • querystring

    protein powder

    Keyword für die Suche in der Meta Ad Library (z. B. „protein powder“).

  • adTypeenum

    Beschränke auf alle Anzeigen (Standard) oder nur politische Anzeigen und Anzeigen zu gesellschaftlichen Themen.

  • countrystring

    US

    Zweistelliger Ländercode, auf den die Ergebnisse begrenzt werden. Weglassen für alle Länder.

  • cursorstring

    Opaker Paginierungs-Cursor aus dem nextCursor einer vorherigen Antwort.

  • endDatestring

    Filtere auf Anzeigen mit Impressionen an oder vor diesem Datum, im Format YYYY-MM-DD.

  • mediaTypeenum

    Filter für den Medientyp des Creatives.

  • requireFieldsarray

    Optional; wenn weggelassen, bleibt das Routing unverändert, und die günstigste Quelle bedient. Nenne die Ausgabefelder, die diese Anfrage zurückgeben können muss, zum Beispiel `totalResults`, und sie wird nur von einer Quelle bedient, die jedes davon zurückgibt. Felder, die du nicht nennst, werden weiterhin zurückgegeben, sobald die bedienende Quelle sie hat. Das kann deinen Preis erhöhen: Wenn die günstigste Quelle ein genanntes Feld nicht zurückgeben kann, bedient eine teurere Quelle, und dir wird ihr Preis genannt und berechnet. Ein genanntes Feld kann bei einer Anzeige, die es tatsächlich nicht hat, trotzdem fehlen. Eine Kombination zu nennen, die keine einzelne Quelle zusammen zurückgibt, wird als ungültige Eingabe ohne Berechnung abgelehnt.

  • searchTypeenum

    keyword_exact_phrase

    Abgleichsmodus der Suchanfrage: lockerer Keyword-Abgleich (keyword_unordered, der Standard) oder exakte Wortgruppe (keyword_exact_phrase).

  • sortByenum

    Sortierreihenfolge: impressions (höchste zuerst, der Standard) oder recent (neueste).

  • startDatestring

    Filtere auf Anzeigen mit Impressionen an oder nach diesem Datum, im Format YYYY-MM-DD.

  • statusenum

    Filter für den Anzeigenstatus.

Du sendest. Ein kleiner JSON-Body. Die gezeigten Werte sind Beispiele, die du durch deine eigenen ersetzt.

Antwort

JSON, ein Beispielwert pro Feld.

each addata.ads[]
  • activeboolean

    true

  • adCountinteger

    3

    Number of ads in this campaign (collation count). Null when the source does not report it.

  • captionstring

    vantagenutrition.com

    Caption line of the ad creative, usually the advertiser's display domain.

  • categoriesstring[]

    Ad Library categories the ad is filed under.

  • ctaTextstring

    Shop Now

    Populated whenever the provider has data for the entity.

  • ctaTypestring

    SHOP_NOW

    Populated whenever the provider has data for the entity.

  • displayFormatstring

    IMAGE

    Populated whenever the provider has data for the entity.

  • endDateinteger

    1758758400

    Epoch seconds.

  • idstring

    705513298640217

    Ad Library archive ID. Populated whenever the provider has data for the entity.

  • isResharedboolean

    false

    Whether the ad creative is a reshare of another post.

  • linkDescriptionstring

    Subscribe and save 20%. Cancel anytime.

    Description text shown under the ad's link.

  • linkUrlstring

    https://vantagenutrition.com/protein

    Populated whenever the provider has data for the entity.

  • pageCategoriesstring[]

    Categories Facebook lists the advertising page under.

  • pageDeletedboolean

    false

    Whether the advertising page has been deleted.

  • pageIdstring

    398201744920331

    Populated whenever the provider has data for the entity.

  • pageLikesinteger

    61300

    Like count of the advertising page.

  • pageNamestring

    Vantage Nutrition

    Populated whenever the provider has data for the entity.

  • pageProfilePicturestring

    https://scontent.fbcdn.net/vantage-profile.jpg

    Profile picture of the advertising page. This is the advertiser's identity image, not ad creative.

  • pageUrlstring

    https://www.facebook.com/vantagenutrition

    Canonical Facebook URL of the advertising page.

  • platformsstring[]

    Populated whenever the provider has data for the entity.

  • sourceUrlstring

    https://www.facebook.com/ads/library/?id=705513298640217

    Inspectable Meta Ad Library URL for this ad. Populated whenever the provider has data for the entity.

  • startDateinteger

    1756512000

    Epoch seconds. Populated whenever the provider has data for the entity.

  • textstring

    20g of grass fed whey, 1g of sugar, zero fillers. Vantage protein powder mixes clean and tastes like an actual milkshake.

    Ad body text. Populated whenever the provider has data for the entity.

  • titlestring

    Protein that doesn't taste like chalk

    Populated whenever the provider has data for the entity.

each creativedata.ads[].creatives[]

One entry per card of a carousel, dynamic-product, or dynamic-creative ad, in the order Meta returns them, each with its own text and destination. Single-creative ads return an empty array. The same card images and videos also appear in media. Meta CDN media URLs are signed and expire.

  • bodystring

    Card body text.

  • captionstring

    Card display caption, usually the destination domain.

  • ctaTextstring

    Card call-to-action label (e.g. "Shop Now").

  • ctaTypestring

    Card call-to-action type (e.g. "SHOP_NOW").

  • imagestring

    Card image URL. For a video card this is the poster frame.

  • linkDescriptionstring

    Card secondary description line.

  • linkUrlstring

    Card destination URL.

  • titlestring

    Card headline.

  • videoUrlstring

    Card video file URL (HD when supplied, otherwise SD). Present only on video cards.

each mediadata.ads[].media[]

Creative attached to the ad: one element per image, video, or carousel card, in the order the ad presents them. Empty when the ad has none.

  • heightinteger

    1080

    Pixel height of the media item, when the lane reports it.

  • typestring

    photo

    One of photo, video, or gif.

  • urlstring

    https://scontent.xx.fbcdn.net/v/t45.1600-4/vantage-protein-tub.jpg

    Image URL. For a video or GIF this is the poster/thumbnail frame.

  • videoUrlstring

    Playable video file URL. Present only for video and gif items.

  • widthinteger

    1080

    Pixel width of the media item, when the lane reports it.

datadata
  • nextCursorstring

    AQHRZ9d3f2k7m1x8c

    Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.

  • totalResultsintegerkann erfordern

    214

    Total number of ads matching the search. Null when the source cannot report an exact count.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Du bekommst zurück. Benannte, typisierte Felder in derselben Struktur, egal welche Quelle antwortet.

Du verkaufst diese API? Hier ist das vollständige Schema, das dein Endpoint zurückgeben muss.

FAQ

Über die Facebook-Anzeigensuche-API

Die AnyAPI-Facebook-Anzeigensuche-API liefert Facebook-Daten als normalisiertes JSON aus einem POST-Aufruf an /v1/run/facebook.ads_search. Durchsuche die Meta Ad Library per Keyword und erhalte passende Anzeigen (Werbetreibender, Creative-Text, CTA, Plattformen und Laufzeiten) mit Cursor-Paginierung. AnyAPI routet jede Anfrage über 5 Quellen und weicht automatisch aus, wenn eine ausfällt. Sie kostet ab 1,05 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. In den letzten 30 Tagen waren 99,9% der Facebook Anzeigensuche-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 1,7 Sekunden über 335.380 gemessene Aufrufe.

Sie kostet ab 1,05 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. Du lädst ein USD-Guthabenkonto auf, und jeder Aufruf bucht davon ab. Bei manchen fehlgeschlagenen, vom Guthabenkonto bezahlten Anfragen fallen Bearbeitungsgebühren an, die wir zum Selbstkostenpreis ohne Aufschlag weitergeben. Die Fehlerantwort zeigt den berechneten Betrag.

Durchsuche die Meta Ad Library per Keyword und erhalte passende Anzeigen (Werbetreibender, Creative-Text, CTA, Plattformen und Laufzeiten) mit Cursor-Paginierung. Die Antwort ist normalisiertes JSON mit demselben Envelope, den jeder AnyAPI-Endpoint liefert, sodass das Parsen eines zweiten Endpoints nur eine geänderte URL bedeutet.

In den letzten 30 Tagen waren 99,9% der Facebook Anzeigensuche-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 1,7 Sekunden über 335.380 gemessene Aufrufe. Das sind AnyAPIs eigene Messungen des Traffics durch das Gateway, laufend neu berechnet, kein veröffentlichtes Service-Level-Ziel.

Ja. Ein neues AnyAPI-Konto startet mit 0,10 USD Gratis-Guthaben, ohne Karte. Das deckt 95 Facebook-Anzeigensuche-Aufrufe zu je 0,00105 USD.

AnyAPI fragt in derselben Anfrage die nächste seiner 5 Quellen, die günstigste zuerst, sodass der Ausfall einer Quelle deinen Aufruf nicht scheitern lässt.

Sende eine POST-Anfrage an https://api.getanyapi.com/v1/run/facebook.ads_search mit deinem AnyAPI-Schlüssel in einem Header „Authorization: Bearer“ und der Eingabe als JSON-Body. Derselbe Schlüssel und dasselbe Guthabenkonto funktionieren bei jedem AnyAPI-Endpoint.

Nein. Du lädst US-Dollar auf ein Prepaid-AnyAPI-Guthaben, und jede Anfrage bucht davon ab. Es gibt keinen Monatstarif und kein Minimum, und dasselbe Guthaben bezahlt jeden AnyAPI-Endpoint.

Ja. Installiere @getanyapi/sdk von npm für TypeScript oder getanyapi von pip für Python. Beide rufen jeden AnyAPI-Endpoint mit demselben Schlüssel auf, und jeder HTTP-Client funktioniert ebenfalls.

Ja. Ein Agent kann sich mit dem AnyAPI-MCP-Server unter https://api.getanyapi.com/mcp verbinden oder mit einem unauthentifizierten POST an https://api.getanyapi.com/agent/signup einen eigenen kostenlosen Test-Schlüssel erstellen und diesen Endpoint über HTTP aufrufen.