Zurück zu den APIs
Unabhängige Facebook-Marketplace-Daten

Facebook Marketplace API

Wandeln Sie Orte in Suchkoordinaten um, finden Sie öffentliche Marketplace-Anzeigen per Stichwort und Standort oder rufen Sie aus bekannten Artikel-URLs detaillierte Daten zu Preis, Verkäufer, Medien, Attributen und Verfügbarkeit ab.

Verfügbare Facebook-Marketplace-APIs

Mit Location Search lösen Sie einen Ort auf, mit Search finden Sie Anzeigen rund um Koordinaten, und mit Item rufen Sie detaillierte Datensätze aus bekannten Marketplace-Artikel-URLs ab.

Welche Facebook-Marketplace-Daten können Sie abrufen?

SocQ liefert normalisierte öffentliche Standortkandidaten, Suchergebnisse zu Anzeigen und Artikeldetails für lokale Marktforschung, Preisanalyse, Bestandsbeobachtung und die Anreicherung von Anzeigen.

Marketplace-Standortkandidaten

Wandelt eine Stadt, Region, ein Viertel oder einen Ortsnamen in Facebook-Standort-IDs, Bezeichnungen, Adresskontext, Breitengrad und Längengrad um.

Identität öffentlicher Anzeigen

Ruft Anzeigen-IDs, Titel, Beschreibungen, Quell-URLs, Kategorien, Texte zum Anzeigedatum und Zeitstempel der Erfassung ab, sofern verfügbar.

Preise und Währungen

Behält verfügbare Preisbeträge, Währungscodes, formatierte Preise und durchgestrichene Preise bei jeder normalisierten Anzeige bei.

Standort- und Lieferdaten

Ruft verfügbare Ortsbezeichnungen, Stadt- und Bundeslandwerte, Koordinaten, Lieferarten, Versandsignale und den Kontext zur Abholung ab.

Medien, Attribute und Verkäuferkontext

Erfasst öffentliche Anzeigenbilder, Artikelattribute, Zustandswerte und Felder zur Identität des Verkäufers, sofern die Quelle sie bereitstellt.

Verfügbarkeit und Anzeigenstatus

Behält Signale wie verfügbar, verkauft, ausstehend, ausgeblendet, live, Nachrichten und Sofort-Kaufen für Anzeigenanalysen zu einem bestimmten Zeitpunkt bei.

SocQ vs Meta Graph API

SocQ konzentriert sich auf die unterstützte Erfassung öffentlicher Marketplace-Daten. Die Graph API von Meta ist für autorisierte Meta-Assets ausgelegt und bietet keine allgemeine öffentliche Marketplace-Suche.

FunktionSocQMeta Graph API
HauptzweckErfassung öffentlicher Marketplace-Standorte, -Suchen und -ArtikelVerwaltung unterstützter Assets, die ein Nutzer oder Unternehmen autorisiert hat
OAuth beim KundenSocQ-API-Schlüssel; kein Facebook-OAuth des KundenMeta-App, Berechtigungen und Zugriffstoken
Suche in öffentlichen AnzeigenUnterstützt mit Stichwort und aufgelöstem StandortKein allgemeiner Endpunkt für die Suche in öffentlichen Marketplace-Anzeigen
Anzeigen erstellen oder bearbeitenNicht unterstütztKein allgemeiner Endpunkt zum Veröffentlichen von Marketplace-Anzeigen für Endnutzer
AntwortformatNormalisierte SocQ-DatensätzeNative Graph-API-Objekte für unterstützte Produkte

So funktioniert die Facebook Marketplace API

Lösen Sie bei Bedarf ein Suchzentrum auf, senden Sie eine Anzeigensuche oder eine bekannte Artikel-URL und lesen Sie die normalisierten Datensätze über den gemeinsamen asynchronen Aufgabenablauf aus.

  1. 1. Ausgangseingabe vorbereiten

    Wandeln Sie einen Ortsnamen in Koordinaten um, nutzen Sie bereits bekannte Koordinaten oder beginnen Sie direkt mit einer öffentlichen Marketplace-Artikel-URL.

  2. 2. Aufgabe senden und verfolgen

    Senden Sie die passende POST-Anfrage, speichern Sie die zurückgegebene task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Normalisierte Ergebnisse lesen

    Verarbeiten Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat.

Standort auflösen und Anzeigen suchen

Lösen Sie zuerst einen Ortsnamen auf und suchen Sie dann mit den Koordinaten des ausgewählten Kandidaten öffentliche Marketplace-Anzeigen.

# Resolve a place name
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Austin"}'

# Search listings around the selected coordinates
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Typische Anwendungsfälle der Facebook Marketplace API

Lokale Anzeigensuche

Lösen Sie ein Marktgebiet auf und suchen Sie öffentliche Anzeigen nach Stichwort, Koordinaten, Umkreis, Preis, Zustand, Liefermethode, Datum oder Verfügbarkeit.

Lokaler Preisvergleich

Vergleichen Sie normalisierte Angebotspreise, Währungen, Titel, Kategorien, Zustände und Standorte ähnlicher öffentlicher Anzeigen.

Regionale Bestandsbeobachtung

Erfassen Sie begrenzte Momentaufnahmen von Anzeigen für ausgewählte Märkte und vergleichen Sie öffentlichen Bestand, Lieferoptionen und Verfügbarkeit im Zeitverlauf.

Anreicherung bekannter Anzeigen

Machen Sie aus bekannten Artikel-URLs detaillierte Datensätze mit Beschreibungen, Verkäuferkontext, Preisen, Standorten, Medien, Attributen und Statusfeldern.

Grenzen und Richtlinie für öffentliche Daten

Marketplace-Ergebnisse sind öffentliche Datensätze zu einem bestimmten Zeitpunkt. Diese APIs bilden die Marketplace-Oberfläche für Endnutzer nicht nach und verwalten weder Anzeigen noch Konten.

  • Location Search erfordert genau eine nicht leere Abfrage mit einem Ortsnamen, akzeptiert results_limit nicht und kann mehrere ähnlich benannte Kandidaten zurückgeben.
  • Prüfen Sie Adresskontext und Koordinaten, bevor Sie einen Standortkandidaten als Zentrum einer Anzeigensuche verwenden.
  • Search erfordert ein nicht leeres Stichwort sowie Breiten- und Längengrad; results_limit hat den Standardwert 100 und akzeptiert ganze Zahlen von 1 bis 2.000.
  • Suchergebnisse können Beschreibungen, Verkäuferangaben, genaue Koordinaten, Attribute und Erstellungszeiten auslassen; doppelte Anzeigen-IDs werden nur einmal gespeichert.
  • Item erfordert unterstützte URLs im Format /marketplace/item/{numeric_id}; jede gültige URL liefert höchstens einen Datensatz, und nicht verfügbare Artikel können übersprungen werden.
  • Ein leeres Ergebnis kann bedeuten, dass es keinen öffentlichen Treffer gibt, die Filter zu restriktiv sind, die Region nicht abgedeckt ist, eine Anzeige nicht verfügbar ist oder eine Grenze der öffentlichen Quelle erreicht wurde.

Häufige Fragen zur Facebook Marketplace API

Was ist die Facebook Marketplace API?

Die Facebook Marketplace API ist eine Gruppe von SocQ-Endpunkten, mit denen Sie Marketplace-Standorte auflösen, öffentliche Anzeigen suchen und detaillierte Datensätze aus bekannten Artikel-URLs abrufen.

Welche Facebook-Marketplace-API sollte ich verwenden?

Verwenden Sie Location Search, um einen Ort aufzulösen, Search, um Anzeigen rund um Koordinaten zu finden, und Item, wenn Sie bereits öffentliche Marketplace-Artikel-URLs haben.

Wie suche ich auf Facebook Marketplace nach Standort?

Senden Sie eine Stadt, Region, ein Viertel oder einen Ortsnamen an Location Search, wählen Sie den passenden Kandidaten aus und übergeben Sie dessen Breiten- und Längengrad an Search.

Was liefert Facebook Marketplace Search?

Search kann Identität der Anzeige, Titel, Beschreibung, Preis, Standort, Bilder, Verkäuferkontext, Kategorie, Lieferoptionen, Statusfelder, Quell-URL und Erfassungszeit zurückgeben.

Wann sollte ich Facebook Marketplace Item verwenden?

Verwenden Sie Item für bekannte öffentliche Artikel-URLs, wenn Sie detaillierte Felder zu Beschreibung, Verkäufer, Preis, Standort, Medien, Attributen, Lieferung und Verfügbarkeit benötigen.

Warum kann die Ergebnisanzahl unter results_limit liegen?

Das Limit ist ein angeforderter Höchstwert. Die Erfassung kann enden, wenn keine weitere öffentliche Seite verfügbar ist, Filter Datensätze ausschließen oder doppelte Anzeigen-IDs entfernt werden.

Wie werden Facebook-Marketplace-Ergebnisse abgerechnet?

Standortkandidaten kosten 0,3 Credits, Search-Anzeigen 0,7 Credits und Item-Datensätze 0,6 Credits pro zurückgegebenem Ergebnis. Für leere Ergebnisse fällt keine Ergebnisgebühr an.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.