Rechercher des produits (listing)

  • 1. Utilisation

    Ce webservice permet de récupérer une liste de produits à partir d’une recherche sur :

    • Des mots-clés
    • Des noms de catégories
    • Un ou une liste d’ID_produit (référence produit Rakuten France)
    • Un ou une liste de références (EAN, ISBN)

    Le résultat de ce Webservice est une liste de produits avec des informations :

    • Produit : titre, image, url, auteur …
    • Offre : le meilleur Prix neuf et le meilleur prix occasion, les 10 premières annonces neuves et occasions

    Conditions d’utilisation des Webservices :

    Les flux envoyés par RAKUTEN FRANCE aux Utilisateurs via les Webservices constituent des extraits de bases de données constituées par RAKUTEN FRANCE ou licenciées à RAKUTEN FRANCE. Ces bases de données sont protégées en application des articles L. 341-1 et suivants du Code de la propriété intellectuelle et demeurent la propriété de leur titulaire. L’Utilisateur peut utiliser les données fournies par RAKUTEN FRANCE uniquement dans le cadre de la gestion de son compte RAKUTEN FRANCE et de ses relations avec la Plateforme et les Membres. Toute autre utilisation, notamment commerciale, est prohibée.

  • 2. Url

    https://ws.fr.shopping.rakuten.com/listing_ssl_ws?action=listing&login=xxxxx&pwd=xxxxx&version=xxxx-xx-xx&scope=xxxxx&nbproducts=xxxxx&kw=xxxxx&nav=xxxxx&refs=xxxxx&productids=xxxxx

  • 3. Paramètres

    Nom Description Obligatoire
    action listing Oui
    login login du vendeur Oui
    pwd Vous avez besoin de votre Token. Plus d’informations ICI. Et vous trouverez votre Token ICI. Oui
    version Version du webservice à utiliser
    Cliquer ici pour voir le dernier numéro de version    		 Oui
    scope Valeurs disponibles :

    • “Sans valeur”, on récupère les informations produits sans les informations concernant les 10 meilleures annonces.
    • PRICING (recherche dans toutes les catégories et ajoute les infos concernant les 10 meilleurs annonces neuves et occasions)
    • LIMITED (ne recherche que dans certaines catégories dans lesquels la mise en vente rapide est disponible en Webservices)
    		 Non
    kw Mot-clé Non
    nav Catégorie de Navigation (nom des catégories visibles dans les url sur le site, dans les catégories de navigation).
    Pour avoir les résultats dans le même ordre de tri que ceux affichés sur le site ajoutez dans l’URL: &withstock=true.    		 Non
    refs ISBN, EAN ou liste d’isbn, ean séparés par des « , » – Un « OU » est appliqué entre chaque ref. Non
    productids Productid (référence produit Rakuten France) ou productid séparés par des « , » – Un « OU » est appliqué entre chaque productid. Non
    nbproductsperpage Nombre de produits par page Non
    (20 par défaut)
    pagenumber Numéro de page Non
    (1 par défaut)

  • 4. XSD

    https://www.fr.shopping.rakuten.com/res/schema/listing/listing.2015-07-05.xsd

  • 5. Erreurs possibles

    Type Code Message Detail
    Sender ParameterError Problem with parameters. The parameter ‘login’ is mandatory.
    Sender ParameterError Problem with parameters. The parameter ‘pwd’ is mandatory.
    Sender ParameterError Problem with parameters. Either ‘kw’, ‘refs’, ‘productids’ or ‘nav’ has to be present
    Sender ParameterError Problem with parameters. You are not allowed to see more than 100 products. Please change pagenumber or nbproductsperpage parameter
    Sender ParameterError Problem with parameters. Your parameter pagenumber must be greater or equals to 1
    Sender ParameterError Problem with parameters. The version xxxx-xx-xx is not supported
    Sender UnknownCategory Category doesn’t exist. Category ‘xxxxxxxx’ doesn’t exist.
    Sender InvalidUserConnection Unknown user or password. Incorrect login or password

  • 6. Données en retour

    Voici une vue générale des données disponibles (se référer au XSD pour les détails).

    Valeur Description
    Lastversion Dernière version disponible du webservice
    resultcount Nombre de résultats de la page
    Totalresultcount Nombre de résultats total
    navigation Description des sous-catégories disponibles et l’url de rappel du Webservice permettant le drilldown
    Productid Identifiant unique produit Rakuten France
    Headline Titre du produit
    Caption Auteur ou marque du produit
    Topic Type de produit
    Offercount Le nombre d’annonces disponibles pour chaque type d’offre
    Bestprices Les meilleurs prix : global, neuf, occasion
    url url du produit sur Rakuten France
    Image url d’une image du produit
    References La liste des références du produit (ean, isbn …)
    Reviews Le nombre d’avis et la note moyenne du produit
    Breadcrumselements La liste d’éléments du chemin de fer, avec l’url de rappel du webservice permettant d’atteindre les catégories listées
    adverts Information disponible avec le scope “PRICING”
    Les listes des annonces regroupées par type (5 neuves / 5 occasions). Pour chaque annonce on retrouve la qualité, le prix, le stock, le pseudo et le type de vendeur, le nombre de ventes, la note, les modes et pays d’expedition

  • 7. Exemple de sortie

    Ouvrir

Privacy Preference Center

Privacy Preferences