DE
Jetzt starten

Facebook · Ads

Facebook Werbebibliothek: Suche Scraper-API

Der Endpunkt Werbebibliothek: Suche von Facebook ist ein API-Aufruf: Senden Sie eine Suchanfrage mit Ihrem HProxy-Schlüssel und erhalten Sie ein sauberes, strukturiertes JSON-Objekt zurück. Durchsuchen Sie die Facebook-Werbebibliothek nach Stichwort und erhalten Sie die Live-Anzeigen mit Creatives, Werbetreibendem, Ausgabenspanne und Laufzeiten zurück. HProxy betreibt die Proxys, Sitzungen, die Anti-Bot-Behandlung und das Parsing auf dem Server, es gibt also keinen Headless-Browser zu beaufsichtigen und keinen Parser, den Sie reparieren müssen, wenn Facebook sein Markup ändert. Sie fassen nur das JSON an. Längere Ergebnismengen kommen Seite für Seite mit einem Cursor zurück, Sie können also die ganze Menge durchgehen, ohne sie im Speicher zu halten.
Ihren API-Schlüssel holenAPI-Referenz für Facebook
  • 0.15¢ pro Aufruf
  • 1,49 $ pro 1.000
  • Nimmt eine Suchanfrage
  • Fehler und Zeitüberschreitungen werden nicht berechnet

Der Aufruf

Ein GET, und Werbebibliothek: Suche kommt als JSON zurück.

Ihr Schlüssel kommt in einen Header. 1 required parameter, and the answer is the object below it.

Die vollständige Referenz
curl "https://hproxy.com/api/v1/scrape/facebook/ad-search?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"
Antwort200 OK · JSON
{
  "advertiser": { "name": "Brand Inc", "pageId": "104..." },
  "creatives": [
    { "format": "video", "body": "Shop the new drop", "media": "https://.../ad.mp4" }
  ],
  "spend": { "min": 5000, "max": 10000, "currency": "USD" },
  "dates": { "firstSeen": "2026-06-30", "lastSeen": "2026-07-17" }
}

Was zurückkommt

Das Objekt Facebook Werbebibliothek: Suche.

creatives[]
Medien, Text und Format jeder aktiven Anzeige.
advertiser
Die Seite oder der Werbetreibende hinter der Anzeige.
spend / impressions
Ausgabenspanne und Reichweite, sofern offengelegt.
dates
Daten der ersten und letzten Sichtung.

Was er nimmt

Parameters.

querystringRequiredcoffee

Suchbegriff oder Stichwort.

sort_bystringtotal_impressions

Ordering to apply to the results. Allowed values: `total_impressions`, `relevancy_monthly_grouped`.

search_typestringkeyword_unordered

The search type parameter. Allowed values: `keyword_unordered`, `keyword_exact_phrase`.

ad_typestringalle

The ad type parameter. Allowed values: `all`, `political_and_issue_ads`.

countrystringUSA

Region- oder Ländercode aus zwei Buchstaben, z. B. DE.

statusstringALL

The status parameter. Allowed values: `ALL`, `ACTIVE`, `INACTIVE`.

media_typestringALL

The media type parameter. Allowed values: `ALL`, `IMAGE`, `VIDEO`, `MEME`, `IMAGE_AND_MEME`, `NONE`.

start_datestring2026-07-01

Nach Datum filtern, als JJJJ-MM-TT.

end_datestring2026-07-01

Nach Datum filtern, als JJJJ-MM-TT.

cursorstring0

Paginierungs-Token aus der vorherigen Antwort.

trimbooleantrue

Eine verschlankte Antwort zurückgeben (ohne ausführliche Felder).

So funktioniert es

Facebook Werbebibliothek: Suche scrapen, in drei Schritten.

Sie schreiben eine Zeile. Proxys, Anti-Bot-Sperren, Rendering und Parsing erledigen wir.

  1. 1

    Kostenloses Konto erstellen

    Registrieren Sie sich und laden Sie einen beliebigen Betrag auf. Das Guthaben bezahlt jedes HProxy-Produkt.
  2. 2

    Holen Sie sich Ihren API-Schlüssel

    Ein Schlüssel aus dem Dashboard authentifiziert jeden Scraper.
  3. 3

    Den Endpunkt aufrufen

    Senden Sie das GET, das Sie brauchen, und lesen Sie das JSON. Das ist die ganze Integration.

Was Leute damit bauen

Wo sich der Endpunkt Facebook Werbebibliothek: Suche bezahlt macht.

  • Beobachten Sie Creatives und Botschaften der Anzeigen Ihrer Konkurrenz.
  • Verfolgen Sie Werbeausgaben und Kampagnen-Timing in Ihrer Nische.
  • Legen Sie eine Sammlung dessen an, was gerade läuft.

Fragen zu Facebook Werbebibliothek: Suche

Beantwortet, bevor Sie fragen.

Die Referenz

Senden Sie eine authentifizierte HTTPS-Anfrage an den Endpunkt Werbebibliothek: Suche von Facebook mit einer Suchanfrage und Ihrem HProxy-API-Schlüssel. Durchsuchen Sie die Facebook-Werbebibliothek nach Stichwort und erhalten Sie die Live-Anzeigen mit Creatives, Werbetreibendem, Ausgabenspanne und Laufzeiten zurück. Keine Proxys, kein Headless-Browser und kein Parsing auf Ihrer Seite. Die Antwort ist sofort nutzbares JSON.

Dieser Endpunkt kostet 0.15¢ pro erfolgreichem Aufruf, also 1,49 $ pro 1.000. Abgerechnet wird über Ihr HProxy-Guthaben, ohne Abo und ohne monatliches Minimum. Fehler werden erneut versucht und nie berechnet; eine Abfrage, deren Ziel nicht existiert, zählt als Aufruf.

Nein. Jeder Aufruf läuft im Hintergrund über das eigene Residential-Netz von HProxy, Anfragen sehen also wie echte Nutzer aus. Die Proxy-Ebene ist im Preis pro Aufruf schon enthalten.

Ein strukturiertes JSON-Objekt mit allen Daten zu Werbebibliothek: Suche, die Facebook öffentlich bereitstellt. Sehen Sie sich die oben aufgeführten Felder an. Das Schema ist über Aufrufe hinweg gleich, Sie integrieren also einmal und können sich darauf verlassen.

Ja. Die Antwort enthält einen Cursor; übergeben Sie ihn beim nächsten Aufruf, um dort weiterzumachen, wo Sie aufgehört haben. Jede Seite ist ein abgerechneter Aufruf, Sie zahlen also nur für die Tiefe, die Sie tatsächlich abrufen.

Die API greift nur auf öffentlich zugängliche Daten von Facebook zu, dieselben Seiten, die jeder in einem Browser öffnen kann. Sie sind dafür verantwortlich, die Daten im Einklang mit den geltenden Gesetzen und den Bedingungen von Facebook für Ihren Anwendungsfall zu nutzen.

Dokumentation und KI

Verbinden Sie Ihren Scraper jederzeit mit einer KI.

Die gesamte Scraper-API liegt als Markdown vor: Ein Assistent liest jeden Endpunkt, jeden Parameter und eine echte Antwort ohne Schlüssel und schreibt Ihre Integration. Und weil ein Scrape ein einziger GET mit JSON-Antwort ist, kann ein Agent den Scraper selbst betreiben, nach eigenem Zeitplan, mit Ihrem Schlüssel.

Scraper-Dokumentation lesenAssistenten einrichten

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama und jeder Assistent, der MCP spricht.

Ein Agent kann sie aufrufen

Ein GET mit Ihrem Schlüssel liefert strukturiertes JSON, ein Agent scrapt also nach eigenem Zeitplan. Kein Browser zu steuern, kein Parser, der zwischen den Läufen gepflegt werden muss.

Endpunkte ansehen

MCP-Server und CLI

Von uns für die kostenlosen Tools gebaut und auf mcp.hproxy.com gehostet: die Proxy-Liste, der Checker und die IP-Abfrage als Tools in Claude, ChatGPT, Cursor oder jedem Assistenten, der MCP spricht. Ohne Installation, ohne Schlüssel.

Zu Ihrem Assistenten hinzufügen

API-Dokumentation

Jeder Scraper-Endpunkt vollständig dokumentiert, mit seinen Parametern und der Antwort, die er wirklich liefert.

Dokumentation lesen

Anzeigen anderswo

Dieselben Daten auf 2 weiteren Plattformen.

Ein Schlüssel, ein JSON-Format, ein Guthaben. Wechseln Sie zur nächsten Plattform, ohne eine zweite API zu lernen.

Ad Library API

Mehr zur API Facebook Werbebibliothek: Suche

Was der Endpunkt Werbebibliothek: Suche von Facebook liefert

Durchsuchen Sie die Facebook-Werbebibliothek nach Stichwort und erhalten Sie die Live-Anzeigen mit Creatives, Werbetreibendem, Ausgabenspanne und Laufzeiten zurück. Das JSON-Objekt enthält creatives[], advertiser, spend / impressions und dates. Bei uns wird nichts weggekürzt, sodass Sie in der Antwort genau das lesen, was die Werbebibliothek: Suche-Seite auf Facebook selbst enthält.

Was Sie an die API Werbebibliothek: Suche von Facebook senden

Der Aufruf braucht eine Suchanfrage. Pflicht: query. Optional: sort_by, search_type, ad_type, country, status, media_type, start_date, end_date, cursor und trim. Ihr Schlüssel steht im Header X-API-Key, die Antwort ist JSON, und der Aufruf kostet 0.15¢, also 1,49 $ pro 1.000.

Anzeigen auf anderen Plattformen

Dieselben Anzeigen-Daten gibt es auf 2 weiteren Plattformen: LinkedIn Werbebibliothek: Suche und Google Werbebibliothek: Anzeigen eines Unternehmens. Sie teilen die JSON-Form dieses Endpunkts, seine Abrechnung pro Aufruf und Ihren einen API-Schlüssel, sodass der Wechsel von Facebook zu einem anderen Netzwerk nur eine andere URL bedeutet und keine zweite Integration.

Ist das Scraping von Werbebibliothek: Suche von Facebook erlaubt?

Der Endpunkt liest öffentlich zugängliche Daten von Facebook, dieselben Seiten, die jeder in einem Browser ohne Login öffnen kann. Er greift nicht auf private Konten oder irgendetwas hinter einem Passwort zu. Wie Sie die Daten dann nutzen, halten Sie selbst rechtmäßig, nach den Regeln, die für Sie und für Facebook gelten.

Bereit, wenn Sie es sind.

Ihr Dashboard ist zehn Sekunden entfernt. Kein Verkaufsgespräch, kein Abo, kein Mindestumsatz.