API

API Temu pour la France : catalogue, variantes et prix en euros (JSON)

Avec `"market": "fr"`, la recherche et la fiche produit passent par la vitrine française de Temu : titres et caractéristiques en français, prix en euros (« 6,29€ »), prix barré quand Temu en affiche un, volume de ventes (« 22K+ ventes »), note et nombre d'avis, puis, sur la fiche, le prix et le stock de chaque variante. L'espace vendeurs de Temu et son programme d'affiliation ont leurs propres accès ; ce service n'en fait pas partie, ne touche à aucune boutique ni à aucune commande, et se contente de lire le catalogue public côté acheteur. La vitrine française a été ajoutée en octobre 2026, à côté de celles des États-Unis, du Royaume-Uni, de l'Allemagne et de la Turquie ; celle du Canada ne sert qu'à la recherche.

Obtenir une clé gratuite Documentation complète : chaque endpoint, chaque paramètre →

Endpoints

endpoint	Ce qui est renvoyé	Obligatoires
search	La première page de résultats d'un mot-clé sur la vitrine choisie, jusqu'à 40 produits : identifiant, `sku_id` de la variante affichée, titre, prix, prix barré (`normal_price`), texte des ventes, note, nombre d'avis, marque quand Temu l'indique, image. Pas de stock sur les cartes ; il est sur la fiche.	query
product/detail	La fiche par `goods_id` ou URL : chaque variante avec son prix, son prix normal, son stock et sa limite d'achat, les images et vidéos, la note, le nombre d'avis, les ventes en chiffre (`sold_quantity`), le chemin de catégories et les caractéristiques en français (« Matériau », « Mode d'alimentation »…). Un article épuisé revient quand même, avec `sold_out: true` et le message de Temu.	tous optionnels

Chaque appel est facturé en crédits. Les appels en échec ou bloqués sont gratuits.

Exemple qui fonctionne

Sur les 20 lampes, 9 affichaient un prix barré (`normal_price`) : 29,00 € au lieu de 48,30 € pour la première. Les nombres d'avis sont convertis en entiers même quand Temu les écrit « 1 441 », avec une espace insécable ; `review_count_display` garde le texte d'origine. `sales_text` reste lui aussi un libellé arrondi (« 22K+ ventes ») : le chiffre exact est sur la fiche, `sold_quantity`, soit 22 000 pour la lampe à 6,29 €, avec 427 pièces en stock ce jour-là.

Requête

curl -X POST https://api.reefapi.com/temu/v1/search \
  -H "x-api-key: VOTRE_CLE" \
  -H "content-type: application/json" \
  -d '{"query": "lampe de chevet", "market": "fr", "max_results": 20}'

Réponse (abrégée)

{
  "ok": true,
  "data": {
    "query": "lampe de chevet",
    "market": "fr",
    "currency": "EUR",
    "results": [
      {
        "goods_id": "601099580241141",
        "sku_id": "17592908674645",
        "title": "2 Lampes de Table Sans Fil | Rechargeables, Contrôle Tactile, 3 Températures de Couleur, Dimmable en Continu, ...",
        "url": "https://www.temu.com/goods.html?goods_id=601099580241141",
        "price": 29.0,
        "price_display": "29,00€",
        "normal_price": 48.3,
        "currency": "EUR",
        "sales_text": "12K+ ventes",
        "rating": 4.8,
        "review_count": 1441,
        "review_count_display": "1 441",
        "brand": null
      },
      {
        "goods_id": "606022047514071",
        "sku_id": "88050721938930",
        "title": "Lampe de chevet tactile recommandée, Lampe de bureau à intensité variable, Lumière LED blanc chaud 3 couleurs, ...",
        "price": 6.29,
        "price_display": "6,29€",
        "normal_price": null,
        "currency": "EUR",
        "sales_text": "22K+ ventes",
        "rating": 4.8,
        "review_count": 669,
        "brand": null
      },
      {
        "goods_id": "601105176816175",
        "title": "Veilleuse à commande tactile, Lampe LED tactile réglable pour chambres à coucher, ...",
        "price": 12.71,
        "price_display": "12,71€",
        "normal_price": null,
        "sales_text": "7K+ ventes",
        "rating": 4.7,
        "review_count": 370,
        "brand": "LIHANGSTAR"
      },
      ...
    ],
    "count": 20,
    "page": 1,
    "next_page": null,
    "pagination_supported": false
  },
  "meta": { "record_count": 20, "cache_hit": false, "mode": "live" }
}

Scraper Temu : ce que la vitrine française change

Sur temu.com/fr, les nombres d'avis s'écrivent avec une espace insécable comme séparateur de milliers (« 2 761 »). Lors de l'ajout de la France, le 18 octobre 2026, la première version de notre parser laissait ce champ vide sur 10 cartes sur 40 ; elle a été corrigée avant l'ouverture, et ce format n'est lu que sur la vitrine française, pour ne rien changer aux autres pays.

Temu ne répond pas toujours à la recherche demandée. Il lui arrive de renvoyer la sélection de sa page d'accueil à la place : pendant nos mesures d'octobre sur la vitrine française, c'est arrivé 3 fois sur 14 pour des requêtes qui avaient bel et bien des résultats. Le moteur ne conclut à « aucun résultat » qu'après plusieurs réponses de ce type, pour ne pas vous renvoyer une page d'accueil comme si c'était votre recherche.

Dans les caractéristiques françaises, une ligne « Poids carré du tissu » apparaît sur le textile. C'est un grammage en g/m², pas le poids du colis ; nous ne la reprenons pas dans `weight`, qui est resté vide sur les 6 fiches françaises vérifiées. Autre piège : un même `goods_id` désigne le même produit partout, mais chaque vitrine a son propre catalogue. Un `goods_id` trouvé sur temu.com aux États-Unis peut ne pas être vendu en France ; la fiche revient alors en NOT_FOUND avec la raison `not_sold_in_market`, sans être facturée.

Si vous suivez des prix Temu en euros, gardez le `sku_id` à côté de chaque relevé. C'est lui qui relie le prix d'une carte de recherche à la variante exacte de la fiche : sur 8 produits français contrôlés en octobre, les deux prix concordaient à chaque fois.

This page in English →Documentation complète : chaque endpoint, chaque paramètre →

Autres documentations en français

Limites et remarques honnêtes

Temu n'a aucun lien avec ce service : ce n'est pas une API Temu, ni pour les vendeurs ni pour les affiliés, et il n'existe aucun partenariat entre ReefAPI et Temu.
Les frais de livraison et le délai ne sont pas publiés sur la fiche consultée sans compte ; ils ne figurent donc dans aucune réponse. Le prix renvoyé est celui de l'article, et un prix promotionnel peut encore différer de celui du panier.
`search` ne lit que la première page, 40 produits au plus ; `page` au-delà de 1 est refusé. Chaque appel coûte 4 crédits, quel que soit `max_results`, et `product/detail` aussi.
Sans `market`, c'est la vitrine américaine qui répond, en dollars. Passez `"market": "fr"` dans chaque appel, recherche comme fiche.
La marque n'apparaît que lorsque Temu l'affiche : 1 carte sur 20 dans notre recherche, et `brand` était aussi vide sur la fiche de la lampe à 6,29 €.
Les formats d'affichage ne sont pas homogènes : sur la même fiche, `price_display` valait « 6,29€ » et celui de la variante « €6.29 ». Pour vos comparaisons, fiez-vous aux nombres (`price`, `normal_price`), pas aux textes.
La fiche donne aussi le nom de la boutique du vendeur ; il n'apporte rien à un suivi de prix et nous l'avons laissé hors de l'exemple.