Rakuten API : produits, avis et classements en JSON
Rakuten publie une API officielle pour Ichiba et elle est réellement ouverte : identifiant d'application gratuit, pas de compte vendeur. Nous le disons franchement, parce que c'est vrai et que le cacher ne servirait à rien. Ce que cette API apporte, c'est le même contenu sans gérer un deuxième jeu d'identifiants, et avec deux choses pratiques : tous les avis paginés et la matrice complète des variantes.
Endpoints
| endpoint | Ce qui est renvoyé | Obligatoires |
|---|---|---|
| search | Recherche par mot-clé ou par rayon, avec tri et filtres de prix. | tous optionnels |
| item | La fiche d'un produit : titre, prix en yens, marque, boutique, note et images. | tous optionnels |
| reviews | Tous les avis acheteurs d'un produit, paginés par 30 : note, texte et date. | tous optionnels |
| variants | La matrice des SKU : chaque combinaison de couleur et de taille avec son propre prix et sa disponibilité. | tous optionnels |
| shop | Le catalogue d'une boutique par son shop_code, paginé. | shop_code |
| ranking | Le classement des meilleures ventes Ichiba, global ou par rayon, par jour, semaine ou temps réel. | tous optionnels |
| genres | L'arbre des rayons Ichiba : les catégories de premier niveau, ou les enfants d'un rayon donné. | tous optionnels |
Chaque appel est facturé en crédits. Les appels en échec ou bloqués sont gratuits.
Exemple qui fonctionne
La matrice des variantes est ce qui manque le plus souvent ailleurs : sur Ichiba, un même produit a des prix différents selon la taille ou la couleur, et une moyenne calculée sur la fiche parente ne veut rien dire.
curl -X POST https://api.reefapi.com/rakuten/v1/ranking \
-H "x-api-key: VOTRE_CLE" \
-H "content-type: application/json" \
-d '{"period": "week"}'{
"ok": true,
"data": {
"results": [
{
"rank": 1,
"item_code": "...",
"title": "...",
"price": 3980,
"currency": "JPY",
"shop": "..."
}
]
},
"meta": { "record_count": 30, "cache_hit": false, "mode": "live" }
}Plutôt que votre propre scraper Rakuten
Pour Rakuten, la réponse honnête commence autrement : leur API officielle est ouverte et gratuite, donc écrire un scraper n'a pas grand sens. Si votre seul besoin est la recherche de base, allez-y directement.
Ce que nous apportons tient à l'intégration : un seul identifiant pour Rakuten et pour les autres places de marché que vous suivez, la même forme de réponse partout, et les avis et variantes déjà paginés.
Si vous ne suivez que Rakuten, l'API officielle suffit et nous ne prétendrons pas le contraire.
Limites et remarques honnêtes
- Ce n'est pas l'API officielle de Rakuten et nous n'avons aucun partenariat avec Rakuten. La leur est ouverte et gratuite : c'est une alternative honnête à considérer.
- Les prix sont en yens, sur Rakuten Ichiba (Japon).
- Les avis ne reviennent que si la fiche en publie ; sinon la liste est vide, ce qui est une réponse et non une erreur.
- Pas de cache : chaque appel reflète l'état au moment de la requête.