Comment convertir du JSON en CSV (et ouvrir le résultat dans Excel)
Transformez un export d'API ou un JSON en tableur. Voyez comment objets et tableaux sont aplatis, ce que deviennent les clés absentes et comment ouvrir le CSV dans Excel.
Mis à jour le 4 novembre 20269 min de lecture
Pour convertir du JSON en CSV, collez le JSON (ou déposez un fichier .json) dans le convertisseur, cliquez sur Convertir en CSV, puis téléchargez le fichier ou copiez le texte. L'outil transforme chaque objet de votre tableau en une ligne, construit l'en-tête à partir de toutes les clés trouvées et joint les objets imbriqués en noms de colonnes séparés par des points, comme user.name. Excel ouvre directement le CSV, ce qui en fait le chemin habituel du « JSON vers Excel ». Ce qui surprend, c'est ce qui arrive aux tableaux, aux clés absentes et à l'ordre des colonnes ; ce guide décrit donc précisément ce que fait l'outil.
Quelle forme de JSON fonctionne
Le convertisseur attend ce que renvoient la plupart des API et des exports : un tableau d'objets, par exemple une liste de commandes ou d'utilisateurs. Chaque objet devient une ligne. Un objet unique fonctionne aussi et donne un tableau d'une seule ligne. Si le tableau contient de simples valeurs au lieu d'objets (nombres ou textes), chacune devient une ligne dans une unique colonne nommée value. Un tableau vide ne produit aucune sortie.
Si votre réponse enveloppe la liste dans un autre objet, par exemple {"data": [ ... ]}, le convertisseur traitera l'ensemble comme une seule ligne avec une colonne contenant la liste sous forme de texte. Copiez uniquement le tableau intérieur et collez-le à la place. Si le JSON n'est pas valide, vous voyez le message « JSON invalide. Vérifiez crochets, virgules, guillemets. » Passez-le d'abord dans le formateur JSON pour repérer l'erreur ; le guide sur la mise en forme du JSON en ligne montre à quoi ressemblent les fautes courantes.
Convertir du JSON en CSV, étape par étape
Ouvrez le convertisseur
Rendez-vous sur le convertisseur JSON vers CSV. Tout s'exécute sur votre appareil, pas sur nos serveurs : un export contenant des données clients n'est donc envoyé nulle part.
Collez le JSON ou déposez le fichier
Collez dans la zone Entrée JSON ou déposez un fichier .json dessus. Pour un fichier, laissez Encodage (fichier) sur UTF-8, sauf si vous savez qu'il a été enregistré dans une page de codes Windows.
Cliquez sur Convertir en CSV
Le CSV apparaît dans la zone de sortie en dessous. Regardez d'abord la ligne d'en-tête : c'est là que l'on voit comment vos champs imbriqués ont été nommés.
Téléchargez ou copiez
Télécharger CSV enregistre un fichier nommé data.csv. Copier CSV place le texte dans le presse-papiers pour le coller dans un tableur ou un autre outil.
Collez ou déposez du JSON, aplatissez-le en colonnes et téléchargez le CSV. Gratuit : un fichier à la fois avec le délimiteur virgule, et aucune limite de lignes fixée par nous ; la limite est donc la mémoire de votre appareil. Pro : choisir point-virgule, tabulation ou barre verticale. S'exécute sur votre appareil.
Convertir JSON en CSVComment les données imbriquées sont aplaties
Un CSV est une grille plate et le JSON est un arbre : il faut bien que quelque chose cède. L'outil suit deux règles simples. Les objets imbriqués sont parcourus en profondeur, et chaque chemin devient un nom de colonne joint par des points. Les tableaux ne sont pas déployés : le tableau entier est écrit dans la cellule sous forme de texte JSON.
| Dans le JSON | Colonne du CSV | Valeur de la cellule |
|---|---|---|
| "name": "Ada" | name | Ada |
| "address": { "city": "Pune" } | address.city | Pune |
| "a": { "b": { "c": 1 } } | a.b.c | 1 |
| "tags": ["x", "y"] | tags | ["x","y"] (en texte, entre guillemets) |
| "items": [{ "id": 1 }] | items | [{"id":1}] (en texte, entre guillemets) |
| "note": null | note | (vide) |
| "paid": true | paid | true |
| "meta": {} | (aucune colonne) | Un objet vide n'ajoute rien |
La conséquence, sans détour : un enregistrement avec cinq lignes de commande dans un tableau ne devient pas cinq lignes. Il reste une seule ligne, avec les articles dans une cellule sous forme de texte. Si vous voulez une ligne par article, extrayez ce tableau intérieur et convertissez-le séparément, en gardant un identifiant de commande dans chaque élément pour pouvoir les rapprocher ensuite. L'outil n'a aucune option pour conserver l'imbrication ou déployer les tableaux, et il n'utilise pas d'autre séparateur que le point pour les chemins.
Clés absentes, ordre des colonnes et cellules vides
Les exports réels sont irréguliers : un client a un numéro de téléphone, le suivant non. Le convertisseur lit d'abord tous les enregistrements et rassemble l'union de tous les noms de colonnes rencontrés. Un enregistrement auquel manque une clé reçoit une cellule vide dans cette colonne, de sorte que toutes les lignes ont le même nombre de cellules et que rien ne se décale. Une valeur null devient elle aussi une cellule vide : le CSV ne distingue donc pas « absent » de « null ».
Les colonnes sont triées par ordre alphabétique, et non selon l'ordre de votre JSON. Le tri se fait par code de caractère : les majuscules passent avant les minuscules et les chiffres avant les lettres. Le champ id ne sera donc pas forcément le premier ; vous déplacerez en général des colonnes dans votre tableur ensuite. Les nombres et les valeurs true/false sont écrits en texte brut, et un nombre JSON comme 12.50 est écrit 12.5.
| Enregistrement | id | name | phone |
|---|---|---|---|
| { "id": 1, "name": "A", "phone": "555-0100" } | 1 | A | 555-0100 |
| { "id": 2, "name": "B" } | 2 | B | (vide) |
| { "id": 3, "name": "C", "phone": null } | 3 | C | (vide) |
Délimiteur, guillemets et encodage
La sortie gratuite utilise toujours une virgule. Choisir un autre délimiteur (point-virgule, tabulation ou barre verticale) est une option Pro du menu Délimiteur. Quel que soit le délimiteur, toute valeur contenant ce délimiteur, un guillemet double ou un saut de ligne est placée entre guillemets doubles, et les guillemets à l'intérieur sont doublés. C'est la méthode standard : des adresses comme « 12 Main St, Apt 4 » restent donc dans une seule cellule.
| Option | Où elle s'applique | Remarques |
|---|---|---|
| Virgule | Par défaut, tous les forfaits | Le CSV le plus largement accepté |
| Point-virgule | Pro | Ce qu'Excel attend dans de nombreux réglages régionaux européens |
| Tabulation | Pro | Valeurs séparées par des tabulations (TSV) |
| Barre verticale | Pro | Certains flux de données |
| UTF-8 / Windows-1252 / ISO-8859-1 | Lecture d'un fichier importé | Ne change que la lecture du fichier .json, pas le CSV que vous téléchargez |
Le menu Encodage (fichier) se comprend facilement de travers. Il commande le décodage d'un fichier JSON importé. Le JSON est presque toujours en UTF-8 ; laissez-le donc tel quel, sauf si des noms accentués apparaissent avec des symboles étranges après le chargement. Le CSV téléchargé est écrit en texte UTF-8 simple, et l'outil n'ajoute pas de marque d'ordre des octets. Si vous collez le JSON au lieu de l'importer, le menu d'encodage n'a aucun effet.
Ouvrir le CSV dans Excel
Un double-clic sur un CSV en UTF-8 sans marque d'ordre des octets peut pousser Excel à supposer un ancien encodage, et les lettres accentuées ou le texte non latin se transforment en caractères étranges. Au lieu du double-clic, ouvrez un classeur vide et utilisez Données, puis À partir d'un fichier texte/CSV, et choisissez UTF-8 comme origine du fichier. La fenêtre d'aperçu permet aussi de fixer le délimiteur, ce qui règle l'autre problème fréquent : dans les régions où Excel attend un point-virgule, un fichier séparé par des virgules atterrit dans une seule colonne. Choisissez Virgule dans cette fenêtre et il se découpe correctement. Le pas-à-pas complet se trouve dans ouvrir un CSV dans Excel correctement.
Deux autres choses se produisent du côté d'Excel et ne viennent pas du convertisseur. Les longs nombres, comme des identifiants de carte ou de suivi à 16 chiffres, s'affichent en notation scientifique, et les valeurs à zéros initiaux comme 00123 perdent leurs zéros. Mettez ces colonnes au format Texte dans l'aperçu d'importation avant de charger. Si vous préférez éviter la boîte d'importation, passez le CSV dans CSV vers Excel pour obtenir un classeur, ou utilisez la visionneuse CSV pour simplement le consulter.
Limites et points à connaître avant un gros export
- Un fichier à la fois. Le convertisseur prend un seul fichier JSON par exécution.
- Pas de plafond de lignes, pas de filigrane. Comme tout s'exécute sur votre appareil, la vraie limite est la mémoire dont il dispose. Un fichier très volumineux peut ralentir la page ; découpez-le d'abord si c'est le cas.
- Tout est du texte. Le CSV n'a pas de types. Les dates restent les chaînes qu'elles étaient dans le JSON, et les nombres ne sont que des chiffres.
- Les formules ne sont pas neutralisées. Une valeur qui commence par = + - ou @ est recopiée telle quelle, et un tableur peut la traiter comme une formule. Vérifiez les exports de sources peu sûres avant de les ouvrir.
- Les points dans les clés peuvent entrer en collision. Une clé nommée littéralement « a.b » et un objet a imbriqué contenant b atterriraient dans la même colonne.
- Le chemin inverse est une étape distincte : CSV vers JSON reconstruit du JSON à partir d'un tableau, sans pouvoir restituer l'imbrication d'origine à l'identique.
Si vous hésitez sur le CSV comme format cible, JSON, CSV ou XML compare ce que chaque format conserve et ce qu'il perd.
Questions fréquentes
Comment convertir du JSON en CSV gratuitement ?
Ouvrez le convertisseur JSON vers CSV, collez votre JSON ou déposez un fichier .json, cliquez sur Convertir en CSV, puis utilisez Télécharger CSV ou Copier CSV. L'offre gratuite donne un fichier à la fois avec le délimiteur virgule, sans limite de lignes fixée par nous.
Comment convertir du JSON en Excel ?
Convertissez d'abord en CSV, puis ouvrez Excel et utilisez Données, À partir d'un fichier texte/CSV, en choisissant UTF-8 et le délimiteur virgule dans l'aperçu. Vous pouvez aussi passer le CSV dans CSV vers Excel pour obtenir un classeur .xlsx.
Que deviennent les objets et tableaux imbriqués ?
Les objets imbriqués deviennent des colonnes distinctes, avec des noms joints par des points comme address.city. Les tableaux ne sont pas répartis en lignes ; le tableau entier est écrit dans une cellule sous forme de texte JSON.
Pourquoi certaines cellules de mon CSV sont-elles vides ?
L'outil rassemble toutes les clés de tous les enregistrements. Un enregistrement qui n'a pas une clé, ou qui la met à null, reçoit une cellule vide dans cette colonne pour que toutes les lignes restent alignées.
Pourquoi les lettres accentuées sont-elles abîmées à l'ouverture du CSV dans Excel ?
Excel peut deviner le mauvais encodage quand on double-clique un fichier UTF-8. Importez-le plutôt via Données, À partir d'un fichier texte/CSV et choisissez UTF-8 comme origine du fichier. Le convertisseur écrit de l'UTF-8 simple et n'ajoute pas de marque d'ordre des octets.
Puis-je utiliser un point-virgule ou une tabulation à la place de la virgule ?
Oui, avec Pro : le menu Délimiteur propose virgule, point-virgule, tabulation et barre verticale. Dans l'offre gratuite, la sortie utilise une virgule, et l'aperçu d'importation d'Excel permet de la choisir comme séparateur.