facebook-marketplace/
item

Collectez les annonces publiques du Facebook Marketplace à partir d’URL d’articles et obtenez, sous forme d’enregistrements normalisés, le contenu de l’annonce, les informations sur le vendeur, le prix, la localisation, les médias et la disponibilité.

Facebook Marketplace Item API

URL d’articles Marketplace
Prix et contexte vendeur
Détails d’annonces publiques
0,6 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 Item

Les articles du Facebook Marketplace sont des annonces publiques qui réunissent titres, descriptions, informations sur le vendeur, prix, localisations, photos, attributs, options de livraison et signaux de disponibilité. Ces champs servent à enrichir une sélection d’annonces, à vérifier prix et statut, à comparer des articles et à conserver des relevés à un instant donné.

Fonctionnalités de la Facebook Marketplace Item API

  • Saisie d’URL d’articles connusTraite les chemins publics de facebook.com, www.facebook.com, m.facebook.com ou web.facebook.com qui commencent par /marketplace/item/{numeric_id}, ce qui limite la collecte aux annonces envoyées.
  • Détails d’annonce normalisésRenvoie l’identité de l’annonce, le titre, la description, le contexte vendeur, le prix, la localisation, les images, les attributs, les valeurs de livraison, les horodatages et les champs publics de disponibilité lorsqu’ils sont exposés.
  • Traitement par lot indépendantChaque URL valide est traitée séparément et donne au plus une annonce : un article indisponible n’empêche donc pas le traitement des autres entrées.
  • Limite claire des données publiquesLes valeurs de vendeur, de localisation, de médias, d’attributs, de livraison et de statut qui dépendent de la source restent nullables, sans détail fictif pour les champs que l’annonce publique n’expose pas.

Paramètres de la Facebook Marketplace Item API

ParamètresObligatoireDescription
urlsObligatoireListe obligatoire et non vide d’URL publiques d’articles du Facebook Marketplace. Les hôtes acceptés sont facebook.com, www.facebook.com, m.facebook.com et web.facebook.com, et chaque chemin doit commencer par /marketplace/item/{numeric_id}.

Comment utiliser la Facebook Marketplace Item API

Envoyez des URL d’articles Marketplace publics que vous connaissez, suivez la tâche asynchrone, puis lisez les enregistrements d’annonces normalisés grâce à la pagination par curseur.

  1. Préparez une ou plusieurs URL publiques du Facebook Marketplace dont le chemin commence par /marketplace/item/{numeric_id}.
  2. Envoyez les liens dans urls à /v1/facebook-marketplace/item et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que le traitement réussisse ou renvoie un échec.
  4. Lisez data.results.items, puis demandez la page suivante avec next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/item" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/marketplace/item/1656586118821988/"]}'

# 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 Item API

  • Enrichir une sélection de résultats de recherche : Servez-vous des descriptions, des champs vendeur, des médias supplémentaires, des attributs, des valeurs de livraison et de la localisation précise pour compléter un ensemble choisi de résultats de recherche Marketplace.
  • Revérifier prix et disponibilité : Comparez le prix normalisé, le prix barré, le texte de disponibilité et les indicateurs en ligne, en attente, vendu, expédition, achat immédiat ou messagerie pour des URL d’annonces connues.
  • Comparer les attributs d’articles choisis : Organisez titres, catégories, attributs d’état, localisations, types de livraison, prix et médias pour une liste définie d’articles publics.
  • Conserver des instantanés d’annonces : Stockez l’identité de l’annonce, l’URL source, le contenu public, les champs d’état, created_at et collected_at comme enregistrement à un instant donné, pour des comparaisons ultérieures.

Conseils d’expert pour la Facebook Marketplace Item API

  • Vérifiez chaque hôte et chaque chemin /marketplace/item/{numeric_id}, puis supprimez les URL en double avant l’envoi : une seule URL invalide fait rejeter la requête, et les doublons exacts ne sont traités qu’une fois.
  • Considérez un nombre d’enregistrements inférieur au nombre d’URL envoyées comme un résultat normal, car un article indisponible ou introuvable est ignoré au lieu de devenir une annonce fictive.
  • Traitez l’identité du vendeur, les coordonnées, la description, les médias, les attributs, les valeurs de livraison, la date de création et les indicateurs d’état publics comme des champs facultatifs qui dépendent de la source.
  • Stockez extra.input_url avec collected_at pour que chaque annonce renvoyée reste liée à l’URL envoyée et à la date d’observation.
  • Si les résultats d’un lot dépassent la page courante, suivez next_cursor tant que has_more vaut true plutôt que de supposer que la première page est complète.

En complément de la Facebook Marketplace Item 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 Search API — Recherchez des annonces publiques du Marketplace par mot-clé et coordonnées avec prix, lieu, médias, catégorie, 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 Item API — FAQ

Facebook Marketplace Item API collecte les détails d’annonces publiques à partir des URL d’articles Marketplace envoyées et renvoie des titres, descriptions, vendeurs, prix, localisations, médias, attributs et champs de disponibilité normalisés.

Envoyez des URL sur facebook.com, www.facebook.com, m.facebook.com ou web.facebook.com dont le chemin commence par /marketplace/item/{numeric_id}. Les autres chemins Facebook et les hôtes extérieurs à Facebook sont rejetés.

Oui. Transmettez un tableau urls non vide ; les chaînes strictement identiques sont supprimées avant les appels au fournisseur, et chaque URL valide distincte donne au plus une annonce.

Un article indisponible ou introuvable ne produit aucun enregistrement fictif, tandis que les autres URL valides continuent d’être traitées.

L’identité du vendeur, les coordonnées, les descriptions, les médias, les attributs, les valeurs de livraison, les horodatages et les indicateurs d’état peuvent rester vides lorsque la source publique ne les expose pas. L’endpoint est en lecture seule : il n’achète, ne vend, ne modifie, ne réserve, n’expédie rien et n’envoie aucun message à propos d’un article.

Chaque annonce renvoyée avec succès coûte 0,6 crédit SocQ. Les URL qui ne produisent aucun enregistrement ne sont pas comptées dans le prix du résultat.