Torna alle API
Dati indipendenti di Facebook Marketplace

Facebook Marketplace API

Trasforma i luoghi in coordinate di ricerca, trova gli annunci pubblici di Marketplace per parola chiave e località o recupera dati dettagliati su prezzo, venditore, media, attributi e disponibilità da URL di articoli noti.

API di Facebook Marketplace disponibili

Usa Location Search per risolvere un luogo, Search per trovare annunci intorno a certe coordinate o Item per recuperare record dettagliati da URL noti di articoli di Marketplace.

Quali dati di Facebook Marketplace puoi recuperare?

SocQ restituisce candidati di località pubbliche, risultati di ricerca di annunci e dettagli degli articoli normalizzati, per ricerche di mercato locali, analisi dei prezzi, monitoraggio dell’inventario e arricchimento degli annunci.

Località candidate di Marketplace

Trasforma il nome di una città, regione, quartiere o luogo in ID di località di Facebook, etichette, contesto dell’indirizzo, latitudine e longitudine.

Identità degli annunci pubblici

Recupera ID degli annunci, titoli, descrizioni, URL di origine, categorie, testo della data dell’annuncio e timestamp di raccolta, quando disponibili.

Prezzi e valute

Conserva importi, codici di valuta, prezzi formattati e prezzi barrati disponibili con ogni annuncio normalizzato.

Dati di località e consegna

Recupera etichette dei luoghi, valori di città e di stato, coordinate, tipi di consegna, segnali di spedizione e contesto del ritiro, quando disponibili.

Media, attributi e contesto del venditore

Raccogli immagini pubbliche degli annunci, attributi degli articoli, valori delle condizioni e campi di identità del venditore quando la fonte li espone.

Disponibilità e stato dell’annuncio

Conserva i segnali di disponibile, venduto, in sospeso, nascosto, attivo, messaggistica e acquisto immediato per l’analisi degli annunci in un dato momento.

SocQ vs Meta Graph API

SocQ si concentra sulla raccolta supportata di dati pubblici di Marketplace. Meta Graph API è pensata per le risorse Meta autorizzate e non offre un’API generale di ricerca pubblica su Marketplace.

FunzionalitàSocQMeta Graph API
Uso principaleRaccolta pubblica di località, ricerche e articoli di MarketplaceGestire le risorse supportate che un utente o un’azienda ha autorizzato
OAuth del clienteChiave API di SocQ; nessun OAuth Facebook del clienteApp Meta, permessi e token di accesso
Ricerca di annunci pubbliciSupportata con una parola chiave e una località risoltaNessun endpoint generale di ricerca pubblica degli annunci di Marketplace
Creare o modificare annunciNon supportatoNessun endpoint generale per pubblicare su Marketplace come consumatore
Formato della rispostaRecord SocQ normalizzatiOggetti nativi di Graph API per i prodotti supportati

Come funzionano le API di Facebook Marketplace

Risolvi un centro di ricerca quando serve, invia una ricerca di annunci o l’URL di un articolo noto, poi leggi i record normalizzati con il flusso condiviso delle attività asincrone.

  1. 1. Prepara l’input iniziale

    Trasforma il nome di un luogo in coordinate, usa coordinate che già conosci oppure parti direttamente da un URL pubblico di un articolo di Marketplace.

  2. 2. Invia e segui l’attività

    Invia la richiesta POST corrispondente, salva il task_id restituito e interroga /v1/tasks/{task_id} finché l’elaborazione termina.

  3. 3. Leggi i risultati normalizzati

    Elabora data.results.items e segui next_cursor finché has_more è true.

Risolvi una località e cerca gli annunci

Risolvi prima il nome di un luogo, poi usa le coordinate del candidato scelto per cercare gli annunci pubblici di Marketplace.

# Resolve a place name
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"}'

# Search listings around the selected coordinates
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'

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

Casi d’uso comuni delle API di Facebook Marketplace

Ricerca di annunci locali

Risolvi un’area di mercato e cerca gli annunci pubblici per parola chiave, coordinate, raggio, prezzo, condizione, metodo di consegna, data o disponibilità.

Confronto dei prezzi locali

Confronta prezzi richiesti, valute, titoli, categorie, condizioni e località normalizzati per annunci pubblici simili.

Monitoraggio dell’inventario regionale

Raccogli istantanee limitate degli annunci per mercati selezionati e confronta nel tempo inventario pubblico, opzioni di consegna e disponibilità.

Arricchimento di annunci noti

Trasforma gli URL di articoli noti in record dettagliati con descrizioni, contesto del venditore, prezzi, località, media, attributi e campi di stato.

Limiti e policy sui dati pubblici

I risultati di Marketplace sono record pubblici rilevati in un dato momento. Queste API non riproducono l’interfaccia di Marketplace per i consumatori né gestiscono annunci e account.

  • Location Search richiede una sola query con il nome di un luogo, non accetta results_limit e può restituire più candidati con nomi simili.
  • Verifica il contesto dell’indirizzo e le coordinate prima di usare una località candidata come centro di una ricerca di annunci.
  • Search richiede una parola chiave non vuota, latitudine e longitudine; results_limit ha come valore predefinito 100 e accetta interi da 1 a 2.000.
  • I risultati di Search possono omettere descrizioni, dettagli del venditore, coordinate precise, attributi e date di creazione, e gli ID di annunci duplicati vengono salvati una sola volta.
  • Item richiede URL supportati /marketplace/item/{numeric_id}; ogni URL valido restituisce al massimo un record e gli articoli non disponibili possono essere saltati.
  • Un risultato vuoto può dipendere dall’assenza di corrispondenze pubbliche, da filtri restrittivi, dalla disponibilità regionale, da un annuncio non disponibile o da un limite della fonte pubblica.

Domande frequenti sulle API di Facebook Marketplace

Che cos’è l’API di Facebook Marketplace?

L’API di Facebook Marketplace è un insieme di endpoint di SocQ per risolvere le località di Marketplace, cercare annunci pubblici e recuperare record dettagliati da URL noti di articoli.

Quale API di Facebook Marketplace devo usare?

Usa Location Search per risolvere un luogo, Search per trovare annunci intorno a certe coordinate e Item quando hai già gli URL pubblici degli articoli di Marketplace.

Come cerco su Facebook Marketplace per località?

Invia il nome di una città, regione, quartiere o luogo a Location Search, scegli il candidato corretto, poi passa a Search la sua latitudine e longitudine.

Che cosa restituisce Facebook Marketplace Search?

Search può restituire identità dell’annuncio, titolo, descrizione, prezzo, località, immagini, contesto del venditore, categoria, opzioni di consegna, campi di stato, URL di origine e orario di raccolta.

Quando devo usare Facebook Marketplace Item?

Usa Item per URL pubblici noti di articoli quando ti servono descrizione dettagliata, venditore, prezzo, località, media, attributi, consegna e campi di disponibilità.

Perché il numero di risultati può essere inferiore a results_limit?

Il limite è un massimo richiesto. La raccolta può fermarsi quando non è disponibile un’altra pagina pubblica, quando i filtri escludono dei record o quando vengono rimossi gli ID di annunci duplicati.

Come vengono fatturati i risultati di Facebook Marketplace?

I candidati di località costano 0,3 crediti, gli annunci di Search 0,7 crediti e i record di Item 0,6 crediti per risultato restituito. I risultati vuoti non hanno costi per risultato.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.