Facebook Marketplace API
Transformez des lieux en coordonnées de recherche, découvrez des annonces publiques du Marketplace par mot-clé et lieu, ou récupérez des données détaillées de prix, de vendeur, de médias, d’attributs et de disponibilité à partir d’URL d’articles connues.
API Facebook Marketplace disponibles
Utilisez Location Search pour résoudre un lieu, Search pour découvrir des annonces autour de coordonnées, ou Item pour récupérer des enregistrements détaillés à partir d’URL d’articles Marketplace connues.
Quelles données du Facebook Marketplace pouvez-vous récupérer ?
SocQ renvoie des candidats de lieux, des résultats de recherche d’annonces et des détails d’articles publics normalisés, pour l’étude de marchés locaux, l’analyse de prix, le suivi des stocks et l’enrichissement d’annonces.
Candidats de lieux Marketplace
Résolvez un nom de ville, de région, de quartier ou de lieu en ID de lieu Facebook, libellés, contexte d’adresse, latitude et longitude.
Identité des annonces publiques
Récupérez les ID d’annonces, titres, descriptions, URL sources, catégories, texte de date de mise en ligne et horodatages de collecte, lorsqu’ils sont disponibles.
Prix et devises
Conservez les montants, codes de devise, prix formatés et prix barrés disponibles avec chaque annonce normalisée.
Données de lieu et de livraison
Récupérez les libellés de lieu, valeurs de ville et d’État, coordonnées, modes de livraison, signaux d’expédition et contexte de retrait disponibles.
Médias, attributs et contexte vendeur
Collectez les images publiques de l’annonce, les attributs de l’article, les valeurs d’état et les champs d’identité du vendeur lorsque la source les expose.
Disponibilité et état de l’annonce
Conservez les signaux disponible, vendu, en attente, masqué, en ligne, messagerie et achat immédiat pour analyser les annonces à un instant donné.
SocQ vs Meta Graph API
SocQ se concentre sur la collecte prise en charge du Marketplace public. La Graph API de Meta est conçue pour les ressources Meta autorisées et ne propose pas d’API générale de recherche publique dans le Marketplace.
| Fonctionnalité | SocQ | Meta Graph API |
|---|---|---|
| Usage principal | Collecte publique de lieux, de recherches et d’articles du Marketplace | Gérer les ressources prises en charge qu’un utilisateur ou une entreprise a autorisées |
| OAuth côté client | Clé API SocQ ; pas d’OAuth Facebook côté client | Application Meta, autorisations et jetons d’accès |
| Recherche d’annonces publiques | Prise en charge avec un mot-clé et un lieu résolu | Aucun endpoint général de recherche d’annonces publiques du Marketplace |
| Créer ou modifier des annonces | Non pris en charge | Aucun endpoint général de publication du Marketplace grand public |
| Format de réponse | Enregistrements SocQ normalisés | Objets natifs de la Graph API pour les produits pris en charge |
Fonctionnement de l’API Facebook Marketplace
Résolvez si besoin un centre de recherche, envoyez une recherche d’annonces ou une URL d’article connue, puis lisez les enregistrements normalisés grâce au flux de tâche asynchrone commun.
1. Préparer l’entrée de départ
Résolvez un nom de lieu en coordonnées, utilisez des coordonnées déjà connues ou partez directement d’une URL d’article publique du Marketplace.
2. Envoyer et suivre la tâche
Envoyez la requête POST correspondante, conservez le task_id renvoyé et interrogez /v1/tasks/{task_id} jusqu’à la fin du traitement.
3. Lire les résultats normalisés
Traitez data.results.items et suivez next_cursor tant que has_more vaut true.
Résolvez d’abord un nom de lieu, puis utilisez les coordonnées du candidat choisi pour rechercher des annonces publiques du Marketplace.
# Resolve a place name
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"}'
# Search listings around the selected coordinates
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 courants de l’API Facebook Marketplace
Découverte d’annonces locales
Résolvez une zone de marché, puis recherchez des annonces publiques par mot-clé, coordonnées, rayon, prix, état, mode de livraison, date ou disponibilité.
Comparaison de prix locaux
Comparez les prix demandés, devises, titres, catégories, états et lieux normalisés d’annonces publiques similaires.
Suivi des stocks régionaux
Collectez des instantanés bornés d’annonces pour des marchés choisis et comparez dans le temps les stocks publics, les options de livraison et la disponibilité.
Enrichissement d’annonces connues
Transformez des URL d’articles connues en enregistrements détaillés avec descriptions, contexte vendeur, prix, lieux, médias, attributs et champs d’état.
Limites et politique sur les données publiques
Les résultats du Marketplace sont des enregistrements publics pris à un instant donné. Ces API ne reproduisent pas l’interface grand public du Marketplace et ne gèrent ni annonces ni comptes.
- Location Search exige une seule requête de nom de lieu non vide, n’accepte pas results_limit et peut renvoyer plusieurs candidats aux noms proches.
- Vérifiez le contexte d’adresse et les coordonnées avant d’utiliser un candidat de lieu comme centre d’une recherche d’annonces.
- Search exige un mot-clé non vide, une latitude et une longitude ; results_limit vaut 100 par défaut et accepte des entiers de 1 à 2 000.
- Les résultats de Search peuvent omettre descriptions, détails du vendeur, coordonnées précises, attributs et dates de création, et les ID d’annonces en double ne sont sauvegardés qu’une fois.
- Item exige des URL /marketplace/item/{numeric_id} prises en charge ; chaque URL valide renvoie au plus un enregistrement et les articles indisponibles peuvent être ignorés.
- Un résultat vide peut refléter l’absence de correspondance publique, des filtres restrictifs, la disponibilité régionale, une annonce indisponible ou une limite de la source publique.
Questions fréquentes sur l’API Facebook Marketplace
Qu’est-ce que l’API Facebook Marketplace ?
L’API Facebook Marketplace est un ensemble d’endpoints SocQ pour résoudre des lieux du Marketplace, rechercher des annonces publiques et récupérer des enregistrements détaillés à partir d’URL d’articles connues.
Quelle API Facebook Marketplace dois-je utiliser ?
Utilisez Location Search pour résoudre un lieu, Search pour découvrir des annonces autour de coordonnées, et Item lorsque vous disposez déjà d’URL d’articles publiques du Marketplace.
Comment rechercher sur le Facebook Marketplace par lieu ?
Envoyez un nom de ville, de région, de quartier ou de lieu à Location Search, choisissez le bon candidat, puis transmettez sa latitude et sa longitude à Search.
Que renvoie Facebook Marketplace Search ?
Search peut renvoyer l’identité de l’annonce, le titre, la description, le prix, le lieu, les images, le contexte vendeur, la catégorie, les options de livraison, les champs d’état, l’URL source et la date de collecte.
Quand utiliser Facebook Marketplace Item ?
Utilisez Item pour des URL d’articles publiques connues lorsque vous avez besoin des champs détaillés de description, de vendeur, de prix, de lieu, de médias, d’attributs, de livraison et de disponibilité.
Pourquoi le nombre de résultats peut-il être inférieur à results_limit ?
La limite est un maximum demandé. La collecte peut s’arrêter lorsqu’aucune page publique supplémentaire n’est disponible, que des filtres excluent des enregistrements ou que des ID d’annonces en double sont supprimés.
Comment les résultats du Facebook Marketplace sont-ils tarifés ?
Les candidats de lieux coûtent 0,3 crédit, les annonces de Search 0,7 crédit et les enregistrements d’Item 0,6 crédit par résultat renvoyé. Un résultat vide n’entraîne aucun frais de résultat.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
X API
Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.
LinkedIn API
Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.
Reddit API
Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.
Pinterest API
Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.
Threads API
Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.
Bluesky API
Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.


