Facebook Marketplace Location Search
Standorte auf Facebook Marketplace sind Ortskandidaten, die sich über Namen, Untertitel, Adressangaben, Stadt- und Postleitzahlenkontext sowie geografische Koordinaten erkennen lassen. Diese Felder unterstützen die eindeutige Zuordnung von Standorten, die Wahl eines Suchzentrums und wiederverwendbare Ortsauswahlen für die lokale Anzeigenrecherche.
Funktionen der Facebook Marketplace Location Search API
- Standortauflösung über OrtsnamenSenden Sie den Namen einer Stadt, Region, eines Stadtviertels oder Orts und erhalten Sie alle Marketplace-Standortkandidaten, die für diese Abfrage zurückgegeben werden.
- Felder zur eindeutigen Zuordnung von StandortenVergleichen Sie Namen, Untertitel, Adresszeilen, Städte, Postleitzahlen, Breiten- und Längengrad der Kandidaten, um gleichnamige Orte zu unterscheiden.
- Nachvollziehbare, normalisierte KandidatenBehält die Facebook-Standort-ID, die ursprüngliche Suchanfrage und die Erfassungszeit bei jedem Kandidaten bei, sodass sich ein gewählter Ort prüfen und wiederverwenden lässt.
Parameter der Facebook Marketplace Location Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Name einer Stadt, Region, eines Stadtviertels oder Orts, zum Beispiel Austin. |
So verwenden Sie die Facebook Marketplace Location Search API
Senden Sie eine Abfrage mit einem Ortsnamen, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Standortkandidaten, die für diese Abfrage zurückgegeben werden.
- Bereiten Sie eine nicht leere Abfrage mit dem Namen einer Stadt, Region, eines Stadtviertels oder Orts vor.
- Senden Sie query an /v1/facebook-marketplace/location-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 folgen Sie next_cursor, solange has_more den Wert true hat.
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"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Facebook Marketplace Location Search API
- Suchzentrum für Anzeigen bestimmen: Wählen Sie Breiten- und Längengrad eines Kandidaten, um das geografische Zentrum bereitzustellen, das Facebook Marketplace Search benötigt.
- Gleichnamige Orte eindeutig zuordnen: Vergleichen Sie Untertitel, Stadt, Postleitzahl, Adresse und Koordinaten, bevor Sie unter Kandidaten mit ähnlichen Namen wählen.
- Daten für eine wiederverwendbare Ortsauswahl: Speichern Sie Standort-ID, Anzeigename, Ortstyp und Koordinaten hinter einer Auswahl für spätere lokale Anzeigenabfragen.
Profi-Tipps zur Facebook Marketplace Location Search API
- Ergänzen Sie Angaben zu Region oder Stadtviertel, wenn ein kurzer Ortsname mehreren Standorten entsprechen könnte.
- Vergleichen Sie Untertitel, Stadt, Postleitzahl, Adresse und Koordinaten, bevor Sie einen gleichnamigen Kandidaten übernehmen.
- Senden Sie kein results_limit, denn die Standortabfrage speichert jeden Kandidaten, der für die Abfrage zurückgegeben wird.
- Fahren Sie mit next_cursor fort, solange has_more den Wert true hat, damit die Paginierung der Aufgabenergebnisse keinen gespeicherten Kandidaten verdeckt.
- Werten Sie eine leere Elementliste als nicht aufgelöste Abfrage, nicht als Beweis dafür, dass Marketplace in dieser Region nicht verfügbar ist.
Verwandte APIs
Ergänzend zur Facebook Marketplace Location Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Facebook Marketplace-Daten benötigen.
- Facebook Marketplace Search API — Öffentliche Marketplace-Anzeigen per Keyword und Koordinaten suchen – mit Kontext zu Preis, Ort, Medien, Kategorie, Lieferung und Verfügbarkeit.
- 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.