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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé d’annonce obligatoire et non vide ; les espaces en début et en fin de chaîne sont supprimés avant l’envoi. |
latitude | Obligatoire | Latitude obligatoire du centre de recherche, exprimée par un nombre de -90 à 90. |
longitude | Obligatoire | Longitude obligatoire du centre de recherche, exprimée par un nombre de -180 à 180. |
results_limit | Facultatif | Nombre 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_km | Facultatif | Rayon de recherche facultatif en kilomètres ; s’il est fourni, il doit être un nombre supérieur à 0. |
min_price | Facultatif | Prix minimal facultatif d’une annonce ; il doit être positif ou nul et ne peut pas dépasser max_price. |
max_price | Facultatif | Prix maximal facultatif d’une annonce ; il doit être positif ou nul et ne peut pas être inférieur à min_price. |
sort_by | Facultatif | Ordre facultatif : suggested, distance_ascend, creation_time_descend, price_ascend ou price_descend. |
delivery_method | Facultatif | Filtre de livraison facultatif : all, local_pickup ou shipping. |
condition | Facultatif | Filtre d’état facultatif : new, used_like_new, used_good ou used_fair. |
date_listed | Facultatif | Filtre d’ancienneté facultatif : all, 1, 7, 30, last_24_hours, last_7_days ou last_30_days. |
availability | Facultatif | Filtre 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.
- Préparez une query non vide, une latitude de -90 à 90, une longitude de -180 à 180 et d’éventuels filtres facultatifs.
- Envoyez la requête en POST à /v1/facebook-marketplace/search, puis 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 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 trueCas 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.
API associées
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é.