Facebook Marketplace Location Search
Les localisations du Facebook Marketplace sont des lieux candidats identifiés par un nom, un sous-titre, des détails d’adresse, un contexte de ville et de code postal, et des coordonnées géographiques. Ces champs servent à lever les ambiguïtés entre lieux, à choisir un centre de recherche et à alimenter des sélecteurs de lieux réutilisables pour l’étude d’annonces locales.
Fonctionnalités de la Facebook Marketplace Location Search API
- Résolution à partir d’un nom de lieuEnvoyez le nom d’une ville, d’une région, d’un quartier ou d’un lieu et recevez tous les lieux candidats du Marketplace renvoyés pour cette recherche.
- Champs de désambiguïsationComparez noms, sous-titres, lignes d’adresse, villes, codes postaux, latitude et longitude pour distinguer des lieux qui portent le même nom.
- Candidats normalisés et traçablesL’ID de localisation Facebook, la requête de recherche d’origine et l’heure de collecte restent attachés à chaque candidat, ce qui permet de revoir et de réutiliser le lieu retenu.
Paramètres de la Facebook Marketplace Location Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Nom obligatoire et non vide d’une ville, d’une région, d’un quartier ou d’un lieu, par exemple Austin. |
Comment utiliser la Facebook Marketplace Location Search API
Envoyez une requête portant sur un nom de lieu, suivez la tâche asynchrone, puis lisez les lieux candidats normalisés renvoyés pour cette recherche.
- Préparez une requête non vide : nom de ville, de région, de quartier ou de lieu.
- Envoyez query à /v1/facebook-marketplace/location-search et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items et suivez next_cursor tant que has_more vaut 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 trueCas d’usage de la Facebook Marketplace Location Search API
- Choix du centre de recherche d’annonces : Retenez la latitude et la longitude d’un candidat pour fournir le centre géographique qu’exige Facebook Marketplace Search.
- Lieux homonymes à départager : Comparez sous-titres, ville, code postal, adresse et coordonnées avant de choisir parmi des candidats aux noms voisins.
- Données pour un sélecteur de lieu réutilisable : Stockez l’ID de localisation, le nom affiché, le type de lieu et les coordonnées derrière un sélecteur, pour de futures recherches d’annonces locales.
Conseils d’expert pour la Facebook Marketplace Location Search API
- Ajoutez la région ou le quartier lorsqu’un nom de lieu court peut correspondre à plusieurs localisations.
- Confrontez le sous-titre, la ville, le code postal, l’adresse et les coordonnées avant d’accepter un candidat homonyme.
- N’envoyez pas results_limit : la recherche de localisation enregistre tous les candidats renvoyés pour la requête.
- Poursuivez avec next_cursor tant que has_more vaut true, afin que la pagination des résultats de tâche ne masque aucun candidat enregistré.
- Voyez dans une liste d’éléments vide une requête non résolue, et non la preuve que le Marketplace est indisponible dans cette région.
API associées
En complément de la Facebook Marketplace Location Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook Marketplace.
- Facebook Marketplace Search API — Recherchez des annonces publiques du Marketplace par mot-clé et coordonnées avec prix, lieu, médias, catégorie, livraison et disponibilité.
- Facebook Marketplace Item API — Collectez le détail d’annonces publiques du Marketplace à partir d’URL d’articles connues avec vendeur, prix, lieu, médias, attributs, livraison et disponibilité.