facebook-marketplace/
location-search

Standortkandidaten für Facebook Marketplace aus einer Abfrage nach Stadt, Region, Stadtviertel oder Ort finden – mit Namen, Ortstypen, Adressen und Koordinaten als normalisierte Datensätze.

Facebook Marketplace Location Search API

Abfrage nach Ortsnamen
Standortkandidaten
Breiten- und Längengrad
0,3 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 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

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, 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.

  1. Bereiten Sie eine nicht leere Abfrage mit dem Namen einer Stadt, Region, eines Stadtviertels oder Orts vor.
  2. Senden Sie query an /v1/facebook-marketplace/location-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 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Facebook Marketplace Location Search API — FAQ

Facebook Marketplace Location Search API wandelt eine nicht leere Abfrage nach Stadt, Region, Stadtviertel oder Ort in normalisierte Standortkandidaten um. Sie liefert Namen, Ortstypen, Adresskontext, Breitengrad, Längengrad und die ursprüngliche Abfrage.

Verwenden Sie einen nicht leeren Namen einer Stadt, Region, eines Stadtviertels oder Orts, zum Beispiel Austin. Zusätzlicher geografischer Kontext hilft, wenn mehrere Orte denselben Namen tragen.

Vergleichen Sie Namen und Untertitel des Kandidaten mit extra.city, extra.postal_code, extra.address, extra.latitude und extra.longitude. Die Standort-ID und die ursprüngliche Suchanfrage bieten zusätzliche Nachvollziehbarkeit.

Nein. Der Endpunkt zum Absenden der Abfrage speichert jeden Kandidaten, der für die Abfrage zurückgegeben wird, während die Antwort der abgeschlossenen Aufgabe gespeicherte Ergebnisdatensätze weiterhin mit next_cursor und has_more paginieren kann.

Wählen Sie den richtigen Kandidaten und übergeben Sie seine Werte extra.latitude und extra.longitude zusammen mit einer Anzeigenabfrage als Suchzentrum an Facebook Marketplace Search.

Ein leeres Array items bedeutet, dass die Standortabfrage die gesendete Anfrage nicht aufgelöst hat. Es belegt nicht, dass Facebook Marketplace in diesem Gebiet nicht verfügbar ist.

Jeder zurückgegebene Standortkandidat kostet 0,3 SocQ-Credits. Eine leere Ergebnismenge verursacht nach der aktuellen Abrechnungskonfiguration keine Ergebnisgebühr.