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à | SocQ | Meta Graph API |
|---|---|---|
| Uso principale | Raccolta pubblica di località, ricerche e articoli di Marketplace | Gestire le risorse supportate che un utente o un’azienda ha autorizzato |
| OAuth del cliente | Chiave API di SocQ; nessun OAuth Facebook del cliente | App Meta, permessi e token di accesso |
| Ricerca di annunci pubblici | Supportata con una parola chiave e una località risolta | Nessun endpoint generale di ricerca pubblica degli annunci di Marketplace |
| Creare o modificare annunci | Non supportato | Nessun endpoint generale per pubblicare su Marketplace come consumatore |
| Formato della risposta | Record SocQ normalizzati | Oggetti 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. 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. 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. Leggi i risultati normalizzati
Elabora data.results.items e segui next_cursor finché has_more è true.
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 trueCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
X API
Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.
LinkedIn API
Recupera dati pubblici di profili, aziende, post e offerte di lavoro su LinkedIn a partire da URL noti, con campi normalizzati su identità, carriera, azienda, contenuti, engagement e offerte.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.
Pinterest API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.
Threads API
Recupera profili Threads pubblici, risolvi post noti o raccogli i post di profili selezionati con campi normalizzati su identità, contenuti, media, engagement e date.
Bluesky API
Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.


