Retour aux API
Données indépendantes du Facebook Marketplace

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éSocQMeta Graph API
Usage principalCollecte publique de lieux, de recherches et d’articles du MarketplaceGérer les ressources prises en charge qu’un utilisateur ou une entreprise a autorisées
OAuth côté clientClé API SocQ ; pas d’OAuth Facebook côté clientApplication Meta, autorisations et jetons d’accès
Recherche d’annonces publiquesPrise en charge avec un mot-clé et un lieu résoluAucun endpoint général de recherche d’annonces publiques du Marketplace
Créer ou modifier des annoncesNon pris en chargeAucun endpoint général de publication du Marketplace grand public
Format de réponseEnregistrements SocQ normalisésObjets 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. 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. 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. 3. Lire les résultats normalisés

    Traitez data.results.items et suivez next_cursor tant que has_more vaut true.

Résoudre un lieu et rechercher des annonces

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 true

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

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.