facebook-marketplace/
item

Raccogli gli articoli pubblici di Facebook Marketplace a partire dagli URL degli annunci, con contenuto, dati del venditore, prezzo e posizione, media e disponibilità come record normalizzati.

Facebook Marketplace Item API

URL degli articoli di Marketplace
Contesto di prezzo e venditore
Dettagli degli annunci pubblici
0,6 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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.

  1. Prepara uno o più URL pubblici di Facebook Marketplace il cui percorso inizia con /marketplace/item/{numeric_id}.
  2. Invia i link come urls a /v1/facebook-marketplace/item e salva il task_id.
  3. Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o restituisce un errore.
  4. 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 true

Casi 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.

Oltre alla Facebook Marketplace Item API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook Marketplace.

Esplora altre piattaforme

Combina i dati di Facebook Marketplace con i dati pubblici delle altre piattaforme social supportate.

Facebook Marketplace Item API — FAQ

Facebook Marketplace Item API raccoglie i dettagli degli annunci pubblici dagli URL di articoli di Marketplace inviati e restituisce titoli, descrizioni, venditori, prezzi, posizioni, media, attributi e campi di disponibilità normalizzati.

Invia URL di facebook.com, www.facebook.com, m.facebook.com o web.facebook.com il cui percorso inizia con /marketplace/item/{numeric_id}. Gli altri percorsi di Facebook e gli host non Facebook vengono rifiutati.

Sì. Invia un array urls non vuoto; le stringhe duplicate esatte vengono rimosse prima delle richieste al provider e ogni URL valido distinto può produrre al massimo un annuncio.

Un articolo non disponibile o non trovato non produce alcun record segnaposto, mentre gli altri URL validi continuano a essere elaborati.

Identità del venditore, coordinate, descrizioni, media, attributi, valori di consegna, timestamp e flag di stato possono essere vuoti quando la fonte pubblica non li espone. L’endpoint è di sola lettura e non permette di acquistare, vendere, modificare, riservare, spedire né inviare messaggi su un articolo.

Ogni annuncio restituito con successo costa 0,6 crediti SocQ. Gli URL che non producono alcun record non rientrano nell’addebito del risultato.