Facebook Marketplace Location Search
Le località di Facebook Marketplace sono luoghi candidati identificati da nomi, sottotitoli, dettagli dell’indirizzo, contesto di città e codice postale e coordinate geografiche. Questi campi servono a distinguere luoghi ambigui, scegliere il centro della ricerca e creare selettori di luoghi riutilizzabili per la ricerca di annunci locali.
Funzionalità della Facebook Marketplace Location Search API
- Risoluzione della località dal nome del luogoInvia il nome di una città, regione, quartiere o luogo e ricevi tutte le località candidate di Marketplace restituite per quella ricerca.
- Campi per distinguere le localitàConfronta nomi dei candidati, sottotitoli, righe dell’indirizzo, città, codici postali, latitudine e longitudine per distinguere i luoghi con lo stesso nome.
- Candidati normalizzati e tracciabiliConserva con ogni candidato l’ID della località Facebook, la query di ricerca originale e il momento della raccolta, così un luogo scelto può essere rivisto e riutilizzato.
Parametri della Facebook Marketplace Location Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Nome obbligatorio e non vuoto di una città, regione, quartiere o luogo, per esempio Austin. |
Come usare la Facebook Marketplace Location Search API
Invia una query con il nome di un luogo, segui l’attività asincrona e leggi le località candidate normalizzate restituite per quella ricerca.
- Prepara una query non vuota con il nome di una città, regione, quartiere o luogo.
- Invia query a /v1/facebook-marketplace/location-search e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività ha successo o restituisce un errore.
- Leggi data.results.items e segui next_cursor finché has_more è true.
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"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Facebook Marketplace Location Search API
- Risoluzione del centro di ricerca degli annunci: Scegli latitudine e longitudine di un candidato per fornire il centro geografico richiesto da Facebook Marketplace Search.
- Distinzione di luoghi con lo stesso nome: Confronta sottotitoli, città, codice postale, indirizzo e coordinate prima di scegliere tra candidati con nomi simili.
- Dati per un selettore di località riutilizzabile: Salva ID della località, nome visualizzato, tipo di luogo e coordinate dietro un selettore, da usare nelle successive ricerche di annunci locali.
Consigli degli esperti per la Facebook Marketplace Location Search API
- Aggiungi il contesto di regione o quartiere quando un nome di luogo breve può corrispondere a più località.
- Confronta sottotitolo, città, codice postale, indirizzo e coordinate prima di accettare un candidato con lo stesso nome.
- Non inviare results_limit, perché la ricerca della località salva tutti i candidati restituiti per la query.
- Prosegui con next_cursor ogni volta che has_more è true, così la paginazione dei risultati dell’attività non nasconde un candidato salvato.
- Considera un elenco di elementi vuoto come una query non risolta, non come la prova che Marketplace non sia disponibile in quella regione.
API correlate
Oltre alla Facebook Marketplace Location Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Facebook Marketplace.
- Facebook Marketplace Search API — Cerca gli annunci pubblici di Marketplace per parola chiave e coordinate con prezzo, località, media, categoria, consegna e disponibilità.
- Facebook Marketplace Item API — Raccoglie annunci pubblici dettagliati di Marketplace dagli URL di articoli noti, con venditore, prezzo, località, media, attributi, consegna e disponibilità.