facebook-marketplace/
search

Öffentliche Facebook-Marketplace-Anzeigen per Keyword und Koordinaten durchsuchen – mit Titeln, Preisen, Standorten, Bildern, Statusfeldern und Quell-URLs als normalisierte Datensätze.

Facebook Marketplace Search API

Eingabe von Keyword und Koordinaten
Geografie- und Anzeigenfilter
1–2.000 angeforderte Ergebnisse
Normalisierte öffentliche Anzeigen
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Facebook Marketplace Search

Anzeigen in der Facebook Marketplace Search sind öffentliche Angebote des lokalen Handels mit Titeln, Preisen, Standorten, Bildern, Verkäuferkontext, Lieferoptionen und Verfügbarkeitssignalen. Diese Felder unterstützen die Recherche zu lokalem Bestand, den Vergleich von Angebotspreisen, die Kategorieanalyse und wiederholbare Marktmomentaufnahmen.

Funktionen der Facebook Marketplace Search API

  • Anzeigensuche nach Keyword und GeografieKombinieren Sie eine nicht leere Abfrage mit den erforderlichen Koordinaten für Breiten- und Längengrad und grenzen Sie öffentliche Anzeigen anschließend mit Umkreis, Preis, Sortierung, Lieferung, Zustand, Datum und Verfügbarkeit ein.
  • Strukturierte Anzeigen- und PreisdatensätzeLiefert Anzeigen-IDs, öffentliche URLs, Titel, verfügbare Beschreibungen, Preisbeträge, Währungen, formatierte Preise und durchgestrichene Werte in einer einheitlichen Struktur.
  • Standort-, Medien- und KlassifizierungskontextBehält zu jedem Ergebnis verfügbare Standortbezeichnungen, Stadt- und Bundeslandwerte, Bildverweise, Kategorie-IDs, Attribute, Lieferarten und den Text zum Einstelldatum bei.
  • Tiefe der öffentlichen SuchkartenBewahrt sichtbare Verkäuferfelder sowie die Kennzeichen für aktiv, ausstehend, verkauft, Versand, Sofortkauf und Nachrichten und lässt Details der Suchkarte leer, wenn das öffentliche Ergebnis sie nicht liefert.

Parameter der Facebook Marketplace Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Keyword für die Anzeigen; führende und nachgestellte Leerzeichen werden vor dem Senden entfernt.
latitudeErforderlichErforderlicher Breitengrad des Suchzentrums, angegeben als Zahl von -90 bis 90.
longitudeErforderlichErforderlicher Längengrad des Suchzentrums, angegeben als Zahl von -180 bis 180.
results_limitOptionalMaximale Anzahl der Anzeigen, die über alle Suchseiten hinweg gespeichert werden; der Standardwert ist 100, zulässig sind ganze Zahlen von 1 bis 2.000.
radius_kmOptionalOptionaler Suchradius in Kilometern; falls angegeben, muss er eine Zahl größer als 0 sein.
min_priceOptionalOptionaler Mindestpreis der Anzeige; er darf nicht negativ sein und max_price nicht überschreiten.
max_priceOptionalOptionaler Höchstpreis der Anzeige; er darf nicht negativ sein und nicht unter min_price liegen.
sort_byOptionalOptionale Sortierung: suggested, distance_ascend, creation_time_descend, price_ascend oder price_descend.
delivery_methodOptionalOptionaler Lieferfilter: all, local_pickup oder shipping.
conditionOptionalOptionaler Zustandsfilter: new, used_like_new, used_good oder used_fair.
date_listedOptionalOptionaler Filter für das Alter der Anzeige: all, 1, 7, 30, last_24_hours, last_7_days oder last_30_days.
availabilityOptionalOptionaler Verfügbarkeitsfilter: available, sold oder all.

So verwenden Sie die Facebook Marketplace Search API

Senden Sie ein Keyword und ein geografisches Zentrum mit optionalen Anzeigenfiltern, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Anzeigen per Cursor-Paginierung.

  1. Bereiten Sie eine nicht leere Abfrage, einen Breitengrad von -90 bis 90, einen Längengrad von -180 bis 180 und beliebige optionale Filter vor.
  2. Senden Sie die Anfrage per POST an /v1/facebook-marketplace/search und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items und fordern Sie den zurückgegebenen next_cursor an, solange has_more den Wert true hat.
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

Anwendungsfälle der Facebook Marketplace Search API

  • Vergleich lokaler Angebotspreise: Vergleichen Sie normalisierte Preisbeträge, Währungen, Titel, Abfragekontext und Standorte ähnlicher öffentlicher Anzeigen innerhalb eines festgelegten Suchgebiets.
  • Regionale Bestands- und Kategorierecherche: Nutzen Sie Kategorie-IDs, Attribute, Lieferarten, Verfügbarkeitsfelder, Bilder und Standortkontext, um einen begrenzten lokalen Anzeigendatensatz zusammenzustellen.
  • Wiederholbare Marktmomentaufnahmen: Behalten Sie Anzeigen-IDs, Preise, Statusfelder, search_query und collected_at bei, um unabhängig erfasste Ergebnisse derselben Suche im Zeitverlauf zu vergleichen.
  • Vorauswahl von Anzeigen: Nutzen Sie öffentliche Anzeigen-URLs, Titel, Preise, Bilder und Verfügbarkeitskontext, um Datensätze für die Folgeprüfung einzelner Artikel auszuwählen.

Profi-Tipps zur Facebook Marketplace Search API

  • Beginnt eine Suche mit einem Ortsnamen statt mit Koordinaten, ermitteln und prüfen Sie zuerst einen Kandidaten aus Location Search, bevor Sie Breiten- und Längengrad senden.
  • Prüfen Sie die Wertebereiche der Koordinaten, halten Sie radius_km über 0, verwenden Sie nicht negative Preise und stellen Sie vor dem Senden sicher, dass min_price max_price nicht überschreitet.
  • Folgen Sie next_cursor, bis has_more den Wert false hat, wenn die gespeicherten Ergebnisse die erste Antwortseite überschreiten; results_limit steuert die Erfassung, nicht die Seitengröße der Aufgabenantwort.
  • Führen Sie wiederholte Momentaufnahmen mit der Anzeigen-ID als Schlüssel und behalten Sie collected_at bei, denn doppelte IDs werden pro Aufgabe nur einmal gespeichert und öffentliche Anzeigen können sich ändern oder verschwinden.
  • Behandeln Sie Beschreibungen, Verkäuferfelder, genaue Koordinaten, Attribute und Erstellungszeiten als optional; nutzen Sie eine zurückgegebene Anzeigen-URL mit Marketplace Item, wenn Sie tiefere öffentliche Details benötigen.

Ergänzend zur Facebook Marketplace Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook Marketplace-Daten benötigen.

  • Facebook Marketplace Location Search API — Suchbegriffe wie Stadt, Region, Stadtteil oder Ortsname in passende Marketplace-Standorte samt Koordinaten auflösen.
  • Facebook Marketplace Item API — Detaillierte öffentliche Marketplace-Anzeigen aus bekannten Artikel-URLs erfassen – mit Feldern zu Verkäufer, Preis, Ort, Medien, Attributen, Lieferung und Verfügbarkeit.

Weitere Plattformen entdecken

Kombinieren Sie Facebook Marketplace-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Facebook Marketplace Search API — FAQ

Facebook Marketplace Search API ruft öffentliche Marketplace-Anzeigen zu einem nicht leeren Keyword rund um erforderliche Koordinaten für Breiten- und Längengrad ab. Sie liefert normalisierte Anzeigenidentität, Titel, Preise, Standorte, Bilder, öffentlichen Verkäuferkontext, Statusfelder, Quell-URLs und Erfassungszeit.

Die Anfrage erfordert query, latitude und longitude. Optionale Einstellungen sind results_limit, radius_km, Mindest- und Höchstpreis, Sortierung, Liefermethode, Zustand, Alter der Anzeige und Verfügbarkeit mit den dokumentierten Enum-Werten.

results_limit ist ein angefordertes Maximum, keine garantierte Anzahl. Die Erfassung endet, wenn keine weitere Quellseite verfügbar ist, und Datensätze mit derselben sichtbaren Anzeigen-ID werden nur einmal gespeichert.

Suchkarten können Beschreibungen, Verkäuferidentität, genaue Koordinaten, Attribute und Erstellungszeiten auslassen. Clients sollten fehlende optionale Felder weglassen oder sicher behandeln, statt sie als Anfragefehler zu werten.

Ein leeres Ergebnis kann bedeuten, dass für Keyword und Koordinaten kein öffentlicher Treffer zurückgegeben wurde, dass die Filter zu streng waren, dass die regionale Verfügbarkeit abwich oder dass die öffentliche Quelle an einer Antwortgrenze stoppte. Prüfen Sie den Standort und lockern Sie die optionalen Filter, bevor Sie es erneut versuchen.

Nutzen Sie Location Search, wenn Sie den Namen einer Stadt, Region, eines Stadtviertels oder Orts kennen, aber keine geprüften Koordinaten. Nutzen Sie Marketplace Item mit einer bekannten Anzeigen-URL, wenn Sie tiefere öffentliche Details brauchen, als eine Suchkarte liefert.

Jeder zurückgegebene Anzeigendatensatz kostet 0,7 SocQ-Credits. Die Kostenschätzung der Anfrage geht von results_limit aus, bei fehlender Angabe von 100, und eine leere Ergebnismenge verursacht keine Ergebnisgebühr.