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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Keyword für die Anzeigen; führende und nachgestellte Leerzeichen werden vor dem Senden entfernt. |
latitude | Erforderlich | Erforderlicher Breitengrad des Suchzentrums, angegeben als Zahl von -90 bis 90. |
longitude | Erforderlich | Erforderlicher Längengrad des Suchzentrums, angegeben als Zahl von -180 bis 180. |
results_limit | Optional | Maximale 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_km | Optional | Optionaler Suchradius in Kilometern; falls angegeben, muss er eine Zahl größer als 0 sein. |
min_price | Optional | Optionaler Mindestpreis der Anzeige; er darf nicht negativ sein und max_price nicht überschreiten. |
max_price | Optional | Optionaler Höchstpreis der Anzeige; er darf nicht negativ sein und nicht unter min_price liegen. |
sort_by | Optional | Optionale Sortierung: suggested, distance_ascend, creation_time_descend, price_ascend oder price_descend. |
delivery_method | Optional | Optionaler Lieferfilter: all, local_pickup oder shipping. |
condition | Optional | Optionaler Zustandsfilter: new, used_like_new, used_good oder used_fair. |
date_listed | Optional | Optionaler Filter für das Alter der Anzeige: all, 1, 7, 30, last_24_hours, last_7_days oder last_30_days. |
availability | Optional | Optionaler 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.
- Bereiten Sie eine nicht leere Abfrage, einen Breitengrad von -90 bis 90, einen Längengrad von -180 bis 180 und beliebige optionale Filter vor.
- Senden Sie die Anfrage per POST an /v1/facebook-marketplace/search und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.