facebook-marketplace/
location-search

Trouvez des lieux candidats du Facebook Marketplace à partir d’une requête sur une ville, une région, un quartier ou un lieu, et obtenez noms, types de lieu, adresses et coordonnées sous forme d’enregistrements normalisés.

Facebook Marketplace Location Search API

Requête par nom de lieu
Lieux candidats
Latitude et longitude
0,3 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
queryObligatoireNom 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.

  1. Préparez une requête non vide : nom de ville, de région, de quartier ou de lieu.
  2. Envoyez query à /v1/facebook-marketplace/location-search et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

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

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

Explorer d’autres plateformes

Combinez les données Facebook Marketplace avec les données publiques d’autres plateformes sociales prises en charge.

Facebook Marketplace Location Search API — FAQ

Facebook Marketplace Location Search API transforme une requête non vide sur une ville, une région, un quartier ou un lieu en candidats de localisation normalisés. Elle renvoie les noms, les types de lieu, le contexte d’adresse, la latitude, la longitude et la requête d’origine.

Indiquez le nom non vide d’une ville, d’une région, d’un quartier ou d’un lieu, comme Austin. Ajouter un contexte géographique aide lorsque le même nom désigne plusieurs endroits.

Comparez le nom et le sous-titre du candidat avec extra.city, extra.postal_code, extra.address, extra.latitude et extra.longitude. L’ID de localisation et la requête de recherche d’origine apportent une traçabilité supplémentaire.

Non. L’endpoint d’envoi enregistre tous les candidats renvoyés pour la requête, tandis que la réponse de la tâche terminée peut quand même utiliser next_cursor et has_more pour paginer les enregistrements stockés.

Choisissez le bon candidat, puis transmettez ses valeurs extra.latitude et extra.longitude comme centre de recherche de Facebook Marketplace Search, avec une requête d’annonces.

Un tableau items vide indique que la recherche de localisation n’a pas résolu la requête envoyée. Cela ne prouve pas que le Facebook Marketplace est indisponible dans cette zone.

Chaque lieu candidat renvoyé coûte 0,3 crédit SocQ. Un jeu de résultats vide n’entraîne aucun frais de résultat dans la configuration de facturation actuelle.