facebook-marketplace/
item

Öffentliche Facebook-Marketplace-Artikel über Anzeigen-URLs abrufen – mit Inhalt der Anzeige, Verkäuferangaben, Preis und Standort, Medien und Verfügbarkeit als normalisierte Datensätze.

Facebook Marketplace Item API

Marketplace-Artikel-URLs
Preis- und Verkäuferkontext
Öffentliche Anzeigendetails
0,6 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 Item

Artikel auf Facebook Marketplace sind öffentliche Anzeigen mit Titeln, Beschreibungen, Verkäuferangaben, Preisen, Standorten, Fotos, Attributen, Versandoptionen und Verfügbarkeitssignalen. Diese Felder unterstützen die Anreicherung ausgewählter Anzeigen, Preis- und Statusprüfungen, den Vergleich von Artikeln und die Dokumentation zu bestimmten Zeitpunkten.

Funktionen der Facebook Marketplace Item API

  • Eingabe bekannter Artikel-URLsVerarbeitet öffentliche Pfade auf facebook.com, www.facebook.com, m.facebook.com oder web.facebook.com, die mit /marketplace/item/{numeric_id} beginnen, und beschränkt die Erfassung auf die gesendeten Anzeigen.
  • Normalisierte AnzeigendetailsLiefert Identität der Anzeige, Titel, Beschreibung, Verkäuferkontext, Preis, Standort, Bilder, Attribute, Lieferwerte, Zeitstempel und öffentliche Verfügbarkeitsfelder, sofern sie sichtbar sind.
  • Unabhängige StapelverarbeitungBehandelt jede gültige URL unabhängig und liefert höchstens eine Anzeige pro URL, sodass ein nicht verfügbarer Artikel die Verarbeitung der übrigen Eingaben nicht stoppt.
  • Klare Grenze öffentlicher DatenHält quellenabhängige Werte zu Verkäufer, Standort, Medien, Attributen, Lieferung und Status nullbar, statt Platzhalterdetails für Felder zu erzeugen, die die öffentliche Anzeige nicht preisgibt.

Parameter der Facebook Marketplace Item API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche, nicht leere Liste öffentlicher URLs von Facebook-Marketplace-Artikeln. Zulässige Hosts sind facebook.com, www.facebook.com, m.facebook.com und web.facebook.com, und jeder Pfad muss mit /marketplace/item/{numeric_id} beginnen.

So verwenden Sie die Facebook Marketplace Item API

Senden Sie bekannte öffentliche Marketplace-Artikel-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Anzeigendatensätze per Cursor-Paginierung.

  1. Bereiten Sie eine oder mehrere öffentliche Facebook-Marketplace-URLs vor, deren Pfad mit /marketplace/item/{numeric_id} beginnt.
  2. Senden Sie die Links als urls an /v1/facebook-marketplace/item und notieren Sie die task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items und fordern Sie mit next_cursor die nächste Seite an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/item" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/marketplace/item/1656586118821988/"]}'

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

Anwendungsfälle der Facebook Marketplace Item API

  • Ausgewählte Suchergebnisse anreichern: Nutzen Sie Beschreibungen, Verkäuferfelder, zusätzliche Medien, Attribute, Lieferwerte und den genauen Standortkontext, um eine ausgewählte Menge von Marketplace-Suchergebnissen zu erweitern.
  • Preis und Verfügbarkeit erneut prüfen: Vergleichen Sie für bekannte Anzeigen-URLs den normalisierten Preis, den durchgestrichenen Preis, den Verfügbarkeitstext und die Kennzeichen für aktiv, ausstehend, verkauft, Versand, Sofortkauf oder Nachrichten.
  • Ausgewählte Artikelattribute vergleichen: Ordnen Sie Titel, Kategorien, Zustandsattribute, Standorte, Lieferarten, Preise und Medien über eine festgelegte Liste öffentlicher Artikel.
  • Momentaufnahmen von Anzeigen festhalten: Speichern Sie Identität der Anzeige, Quell-URL, öffentlichen Inhalt, Statusfelder, created_at und collected_at als Datensatz zu einem bestimmten Zeitpunkt für spätere Vergleiche.

Profi-Tipps zur Facebook Marketplace Item API

  • Prüfen Sie vor dem Senden jeden Host und jeden Pfad /marketplace/item/{numeric_id} und entfernen Sie doppelte URL-Zeichenfolgen, denn eine ungültige URL lehnt die gesamte Anfrage ab und exakte Duplikate werden nur einmal verarbeitet.
  • Werten Sie weniger zurückgegebene Datensätze als gesendete URLs als gültiges Ergebnis, denn ein nicht verfügbarer oder nicht gefundener Artikel wird übersprungen, statt zu einer Platzhalter-Anzeige zu werden.
  • Behandeln Sie Verkäuferidentität, Koordinaten, Beschreibung, Medien, Attribute, Lieferwerte, Erstellungszeit und öffentliche Statuskennzeichen als optionale, quellenabhängige Felder.
  • Speichern Sie extra.input_url zusammen mit collected_at, damit jede zurückgegebene Anzeige ihrer gesendeten URL und ihrem Beobachtungszeitpunkt zugeordnet bleibt.
  • Folgen Sie bei Stapeln, deren erfolgreiche Ergebnisse die aktuelle Ergebnisseite überschreiten, next_cursor, solange has_more den Wert true hat, statt die erste Seite für vollständig zu halten.

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

Weitere Plattformen entdecken

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

Facebook Marketplace Item API — FAQ

Facebook Marketplace Item API erfasst öffentliche Anzeigendetails aus gesendeten Marketplace-Artikel-URLs und liefert normalisierte Titel, Beschreibungen, Verkäufer, Preise, Standorte, Medien, Attribute und Verfügbarkeitsfelder.

Senden Sie URLs auf facebook.com, www.facebook.com, m.facebook.com oder web.facebook.com, deren Pfad mit /marketplace/item/{numeric_id} beginnt. Andere Facebook-Pfade und Hosts außerhalb von Facebook werden abgelehnt.

Ja. Senden Sie ein nicht leeres Array urls; exakt doppelte Zeichenfolgen werden vor den Anbieteranfragen entfernt, und jede eindeutige gültige URL kann höchstens eine Anzeige liefern.

Ein nicht verfügbarer oder nicht gefundener Artikel erzeugt keinen Platzhalter-Datensatz, während die übrigen gültigen URLs weiterverarbeitet werden.

Verkäuferidentität, Koordinaten, Beschreibungen, Medien, Attribute, Lieferwerte, Zeitstempel und Statuskennzeichen können leer sein, wenn die öffentliche Quelle sie nicht preisgibt. Der Endpunkt arbeitet nur lesend und kauft, verkauft, bearbeitet, reserviert oder versendet keinen Artikel und schreibt auch keine Nachrichten dazu.

Jede erfolgreich zurückgegebene Anzeige kostet 0,6 SocQ-Credits. URLs, die keinen Datensatz liefern, werden bei der Ergebnisgebühr nicht berücksichtigt.