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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche, 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.
- Bereiten Sie eine oder mehrere öffentliche Facebook-Marketplace-URLs vor, deren Pfad mit /marketplace/item/{numeric_id} beginnt.
- Senden Sie die Links als urls an /v1/facebook-marketplace/item und notieren Sie die task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich abgeschlossen ist oder einen Fehler zurückgibt.
- 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 trueAnwendungsfä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.
Verwandte APIs
Ergänzend zur Facebook Marketplace Item 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 Search API — Öffentliche Marketplace-Anzeigen per Keyword und Koordinaten suchen – mit Kontext zu Preis, Ort, Medien, Kategorie, Lieferung und Verfügbarkeit.