facebook-marketplace/
search

Recherchez des annonces publiques du Facebook Marketplace par mot-clé et coordonnées, et obtenez titres, prix, localisations, images, champs d’état et URL sources sous forme d’enregistrements normalisés.

Facebook Marketplace Search API

Mot-clé et coordonnées en entrée
Filtres géographiques et d’annonce
De 1 à 2 000 résultats demandés
Annonces publiques normalisées
0,7 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 Search

Les annonces issues de la recherche du Facebook Marketplace sont des offres publiques de commerce local, avec titres, prix, localisations, images, contexte du vendeur, options de livraison et signaux de disponibilité. Ces champs servent à étudier le stock local, à comparer les prix demandés, à analyser les catégories et à produire des instantanés de marché reproductibles.

Fonctionnalités de la Facebook Marketplace Search API

  • Recherche d’annonces par mot-clé et par zoneAssociez une requête non vide à une latitude et une longitude obligatoires, puis affinez les annonces publiques par rayon, prix, tri, livraison, état, date et disponibilité.
  • Enregistrements structurés d’annonces et de prixRenvoie les ID d’annonce, les URL publiques, les titres, les descriptions disponibles, les montants, les devises, les prix formatés et les valeurs barrées dans une forme cohérente.
  • Contexte de lieu, de médias et de classementChaque résultat conserve les libellés de localisation disponibles, la ville et l’État, les références d’images, les ID de catégorie, les attributs, les types de livraison et le texte de date de mise en ligne.
  • Profondeur des fiches de résultats publiquesLes champs du vendeur exposés et les indicateurs en ligne, en attente, vendu, expédition, achat immédiat et messagerie sont conservés ; les détails absents du résultat public restent vides.

Paramètres de la Facebook Marketplace Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé d’annonce obligatoire et non vide ; les espaces en début et en fin de chaîne sont supprimés avant l’envoi.
latitudeObligatoireLatitude obligatoire du centre de recherche, exprimée par un nombre de -90 à 90.
longitudeObligatoireLongitude obligatoire du centre de recherche, exprimée par un nombre de -180 à 180.
results_limitFacultatifNombre maximal d’annonces à enregistrer sur l’ensemble des pages de recherche ; vaut 100 par défaut et accepte les entiers de 1 à 2 000.
radius_kmFacultatifRayon de recherche facultatif en kilomètres ; s’il est fourni, il doit être un nombre supérieur à 0.
min_priceFacultatifPrix minimal facultatif d’une annonce ; il doit être positif ou nul et ne peut pas dépasser max_price.
max_priceFacultatifPrix maximal facultatif d’une annonce ; il doit être positif ou nul et ne peut pas être inférieur à min_price.
sort_byFacultatifOrdre facultatif : suggested, distance_ascend, creation_time_descend, price_ascend ou price_descend.
delivery_methodFacultatifFiltre de livraison facultatif : all, local_pickup ou shipping.
conditionFacultatifFiltre d’état facultatif : new, used_like_new, used_good ou used_fair.
date_listedFacultatifFiltre d’ancienneté facultatif : all, 1, 7, 30, last_24_hours, last_7_days ou last_30_days.
availabilityFacultatifFiltre de disponibilité facultatif : available, sold ou all.

Comment utiliser la Facebook Marketplace Search API

Envoyez un mot-clé et un centre géographique avec des filtres d’annonce facultatifs, suivez la tâche asynchrone, puis lisez les annonces normalisées grâce à la pagination par curseur.

  1. Préparez une query non vide, une latitude de -90 à 90, une longitude de -180 à 180 et d’éventuels filtres facultatifs.
  2. Envoyez la requête en POST à /v1/facebook-marketplace/search, puis 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 demandez le next_cursor renvoyé tant que has_more reste à true.
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

Cas d’usage de la Facebook Marketplace Search API

  • Comparaison locale des prix demandés : Comparez les montants normalisés, les devises, les titres, le contexte de requête et les localisations d’annonces publiques similaires dans une zone de recherche définie.
  • Étude régionale du stock et des catégories : Appuyez-vous sur les ID de catégorie, les attributs, les types de livraison, les champs de disponibilité, les images et le contexte de lieu pour constituer un jeu de données d’annonces locales borné.
  • Instantanés de marché reproductibles : Conservez les ID d’annonce, les prix, les champs d’état, search_query et collected_at pour comparer dans le temps des résultats collectés séparément pour une même recherche.
  • Préparation d’une présélection d’annonces : Utilisez les URL publiques, titres, prix, images et éléments de disponibilité pour choisir les enregistrements à approfondir article par article.

Conseils d’expert pour la Facebook Marketplace Search API

  • Quand une recherche part d’un nom de lieu plutôt que de coordonnées, résolvez et vérifiez un candidat de Location Search avant d’envoyer latitude et longitude.
  • Avant l’envoi, contrôlez les plages de coordonnées, gardez radius_km au-dessus de 0, utilisez des prix positifs ou nuls et assurez-vous que min_price ne dépasse pas max_price.
  • Suivez next_cursor jusqu’à ce que has_more passe à false lorsque les résultats stockés dépassent la première page de réponse ; results_limit règle la collecte, pas la taille de page de la réponse de tâche.
  • Identifiez les instantanés répétés par ID d’annonce et conservez collected_at : les ID en double ne sont stockés qu’une fois par tâche, et les annonces publiques peuvent changer ou disparaître.
  • Considérez descriptions, champs du vendeur, coordonnées précises, attributs et dates de création comme facultatifs ; si vous avez besoin de plus de détails publics, passez l’URL d’une annonce renvoyée à Marketplace Item.

En complément de la Facebook Marketplace Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Facebook Marketplace.

  • Facebook Marketplace Location Search API — Transformez des requêtes de ville, de région, de quartier ou de nom de lieu en lieux candidats du Marketplace avec leurs coordonnées.
  • 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 Search API — FAQ

Facebook Marketplace Search API récupère les annonces publiques du Marketplace pour un mot-clé non vide, autour de coordonnées de latitude et de longitude obligatoires. Elle renvoie l’identité normalisée de l’annonce, les titres, les prix, les localisations, les images, le contexte public du vendeur, les champs d’état, les URL sources et l’heure de collecte.

La requête exige query, latitude et longitude. Les options comprennent results_limit, radius_km, les prix minimal et maximal, l’ordre de tri, le mode de livraison, l’état, l’ancienneté de l’annonce et la disponibilité, avec les valeurs d’énumération documentées.

results_limit est un maximum demandé, pas un nombre garanti. La collecte s’arrête quand la source n’a plus de page supplémentaire, et les enregistrements qui portent le même ID d’annonce exposé ne sont enregistrés qu’une fois.

Les fiches de résultats peuvent omettre descriptions, identité du vendeur, coordonnées précises, attributs et dates de création. Côté client, omettez ou gérez sans risque les champs facultatifs absents au lieu d’y voir un échec de la requête.

Un résultat vide peut signifier qu’aucune correspondance publique n’a été renvoyée pour le mot-clé et les coordonnées, que les filtres étaient trop restrictifs, que la disponibilité régionale différait ou que la source publique s’est arrêtée à une limite de réponse. Vérifiez le lieu et élargissez les filtres facultatifs avant de réessayer.

Utilisez Location Search lorsque vous avez le nom d’une ville, d’une région, d’un quartier ou d’un lieu, mais pas de coordonnées vérifiées. Utilisez Marketplace Item avec l’URL d’une annonce connue lorsqu’il vous faut plus de détails publics que n’en offre une fiche de résultats.

Chaque annonce renvoyée coûte 0,7 crédit SocQ. L’estimation de la requête se base sur results_limit, ou sur 100 s’il est omis, et un jeu de résultats vide n’entraîne aucun frais de résultat.