Facebook Marketplace Item
Gli articoli di Facebook Marketplace sono annunci pubblici con titoli, descrizioni, dati del venditore, prezzi, posizioni, foto, attributi, opzioni di consegna e segnali di disponibilità. Questi campi permettono di arricchire annunci selezionati, controllare prezzo e stato, confrontare gli articoli e conservare registrazioni puntuali nel tempo.
Funzionalità della Facebook Marketplace Item API
- Input con URL di articoli notiElabora i percorsi pubblici di facebook.com, www.facebook.com, m.facebook.com o web.facebook.com che iniziano con /marketplace/item/{numeric_id}, limitando la raccolta agli annunci inviati.
- Dettagli normalizzati dell’annuncioRestituisce identità dell’annuncio, titolo, descrizione, contesto del venditore, prezzo, posizione, immagini, attributi, valori di consegna, timestamp e campi pubblici di disponibilità, quando sono esposti.
- Elaborazione indipendente dei batchGestisce ogni URL valido in modo indipendente e restituisce al massimo un annuncio per URL, così un articolo non disponibile non blocca l’elaborazione degli altri input.
- Confine esplicito dei dati pubbliciMantiene nullable i valori di venditore, posizione, media, attributi, consegna e stato che dipendono dalla fonte, invece di creare dettagli segnaposto per i campi che l’annuncio pubblico non espone.
Parametri della Facebook Marketplace Item API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio e non vuoto di URL pubblici di articoli di Facebook Marketplace. Gli host accettati sono facebook.com, www.facebook.com, m.facebook.com e web.facebook.com, e ogni percorso deve iniziare con /marketplace/item/{numeric_id}. |
Come usare la Facebook Marketplace Item API
Invia gli URL pubblici di articoli di Marketplace che già conosci, segui l’attività asincrona e leggi i record normalizzati degli annunci con la paginazione a cursore.
- Prepara uno o più URL pubblici di Facebook Marketplace il cui percorso inizia con /marketplace/item/{numeric_id}.
- Invia i link come urls a /v1/facebook-marketplace/item e salva il task_id.
- Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o restituisce un errore.
- Leggi data.results.items, poi richiedi la pagina successiva con next_cursor finché has_more è true.
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 trueCasi d’uso della Facebook Marketplace Item API
- Arricchire risultati di ricerca selezionati: Usa descrizioni degli annunci, campi del venditore, media aggiuntivi, attributi, valori di consegna e contesto preciso della posizione per ampliare un gruppo scelto di risultati di ricerca di Marketplace.
- Ricontrollare prezzo e disponibilità: Confronta prezzo normalizzato, prezzo barrato, testo di disponibilità e flag di annuncio attivo, in sospeso, venduto, con spedizione, acquisto immediato o messaggistica per gli URL di annunci noti.
- Confrontare gli attributi di articoli selezionati: Organizza titoli, categorie, attributi di condizione, posizioni, tipi di consegna, prezzi e media in un elenco definito di articoli pubblici.
- Conservare istantanee degli annunci: Salva identità dell’annuncio, URL di origine, contenuto pubblico, campi di stato, created_at e collected_at come record puntuale per confronti successivi.
Consigli degli esperti per la Facebook Marketplace Item API
- Verifica ogni host e ogni percorso /marketplace/item/{numeric_id} e rimuovi le stringhe URL duplicate prima dell’invio, perché un solo URL non valido fa rifiutare la richiesta e i duplicati esatti vengono elaborati una sola volta.
- Considera un risultato valido anche un numero di record restituiti inferiore agli URL inviati, perché un articolo non disponibile o non trovato viene saltato invece di diventare un annuncio segnaposto.
- Tratta identità del venditore, coordinate, descrizione, media, attributi, valori di consegna, data di creazione e flag di stato pubblico come campi facoltativi che dipendono dalla fonte.
- Salva extra.input_url insieme a collected_at, così ogni annuncio restituito resta collegato all’URL inviato e al momento dell’osservazione.
- Per i batch in cui i risultati riusciti superano la pagina corrente, segui next_cursor finché has_more è true invece di dare per completa la prima pagina.
API correlate
Oltre alla Facebook Marketplace Item API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook Marketplace.
- Facebook Marketplace Location Search API — Trasforma query con città, regione, quartiere o nome di un luogo in candidati di località di Marketplace e coordinate.
- Facebook Marketplace Search API — Cerca gli annunci pubblici di Marketplace per parola chiave e coordinate con prezzo, località, media, categoria, consegna e disponibilità.