Convertir JSON en CSV : guide simple et gratuit

Apprendre à convertir JSON en CSV est l'une de ces petites compétences qui vous font gagner des heures de copier-coller fastidieux. Les API, les webhooks et les applications modernes vous remettent des données au format JSON, mais les tableurs, les comptables et les outils de reporting veulent des lignes et des colonnes bien rangées. Si vous avez déjà ouvert un fichier JSON dans Excel ou Google Sheets et vu un mur de texte entassé dans une seule cellule, vous connaissez le problème. La bonne nouvelle, c'est que la conversion est simple une fois que vous comprenez à quoi sert chaque format, et vous pouvez la faire dans votre navigateur.

Pourquoi les tableurs veulent du CSV, pas du JSON

JSON et CSV ont été conçus pour des tâches différentes. JSON, abréviation de JavaScript Object Notation, a été conçu pour que les machines échangent des données structurées. Un seul enregistrement peut contenir du texte, des chiffres, des listes et d'autres enregistrements imbriqués en son sein. Cette flexibilité est la raison pour laquelle les développeurs l'adorent, et pourquoi les tableurs peinent avec lui : un tableur est une grille, et chaque valeur a besoin d'une ligne et d'une colonne.

CSV, ou valeurs séparées par des virgules, correspond parfaitement à la grille. La première ligne nomme les colonnes, et chaque ligne suivante est un enregistrement. Excel, Google Sheets, LibreOffice et presque tous les outils d'importation de bases de données peuvent ouvrir un fichier CSV directement. C'est pourquoi les équipes financières demandent des exports CSV, pourquoi les outils d'e-mail acceptent des listes de contacts CSV, et pourquoi les analystes commencent la plupart de leurs projets en transformant des réponses d'API en CSV.

Les fichiers CSV sont aussi du texte brut, donc ils sont petits et faciles à inspecter. Une réponse d'API inclut souvent des champs dont vous n'avez pas besoin, comme des identifiants internes et des métadonnées, et la conversion en CSV vous oblige à choisir les colonnes qui comptent. Si le JSON brut ressemble à une seule longue ligne illisible, passez-le d'abord dans un formateur JSON pour pouvoir voir sa structure.

Convertir JSON en CSV : à quoi ressemble une conversion propre

Une conversion propre suit une règle simple : chaque objet JSON devient une ligne, et chaque champ devient une colonne. Les noms des champs deviennent la ligne d'en-tête en haut du fichier, et les valeurs s'alignent en dessous dans le même ordre. Quand tous les enregistrements ont les mêmes champs, le résultat est un tableau ordonné que n'importe quel tableur ouvre sans se plaindre.

Trois détails séparent un CSV propre d'un CSV cassé. D'abord, le texte contenant une virgule doit être entouré de guillemets doubles, sinon votre tableur le divisera en deux colonnes — un nom d'entreprise comme Smith, Jones and Co a besoin de guillemets autour de lui. Ensuite, les guillemets à l'intérieur du texte sont doublés : she said "hello" devient "she said ""hello""" en CSV. Enfin, les chiffres et les dates doivent garder un format cohérent, pour que les montants utilisent toujours le même nombre de décimales.

L'encodage compte aussi. Si vos données contiennent des caractères accentués ou des symboles de monnaie, enregistrez le CSV en UTF-8. Excel sous Windows lit parfois mal les fichiers UTF-8, donc si les noms accentués se transforment en symboles étranges, importez le fichier avec l'Assistant Importation de texte d'Excel et choisissez UTF-8 au lieu de double-cliquer dessus. Enfin, vérifiez que tous les enregistrements ont les mêmes champs ; s'il manque un champ à l'un d'eux, cette cellule doit rester vide plutôt que de décaler les valeurs suivantes dans les mauvaises colonnes.

Données imbriquées : la partie délicate pour convertir JSON en CSV

Le JSON plat se convertit facilement, mais les données réelles des API sont rarement plates. Un enregistrement client peut contenir un objet adresse avec des champs de rue, de ville et de code postal, ou une liste de commandes passées. Un tableur n'a aucun moyen de stocker un objet dans une cellule, donc les données imbriquées doivent être aplaties avant de devenir du CSV.

L'approche la plus courante est la notation par points : chaque champ imbriqué devient sa propre colonne, avec le chemin joint par des points. Un objet adresse avec un champ ville devient une colonne appelée address.city, et un code postal devient address.postcode. Cela conserve toutes les informations, et les noms des colonnes montrent toujours d'où vient chaque valeur. Cela fonctionne bien quand l'imbrication n'a qu'un ou deux niveaux de profondeur, ce qui couvre la plupart des réponses d'API.

Les listes sont plus difficiles, car un enregistrement peut contenir de nombreux éléments. Une commande avec trois produits ne peut pas tenir dans une seule ligne sans décision. Vous avez trois options : une ligne par article, en répétant les détails de la commande, ce qui est le mieux quand vous devez analyser ou additionner les articles ; joindre les articles dans une seule cellule, séparés par un point-virgule, ce qui garde une ligne par commande mais est plus difficile à analyser ; ou diviser les données en deux fichiers, un pour les commandes et un pour les articles, liés par un identifiant de commande. Quel que soit votre choix, appliquez-le à chaque enregistrement — mélanger les approches fait que les colonnes signifient des choses différentes sur des lignes différentes.

Un exemple concret pas à pas

Imaginez que vous teniez une petite boutique en ligne et que votre système de commandes vous remette ce JSON : un tableau de quatre commandes, chacune avec le nom du client, une adresse e-mail et un montant.

• { "name": "Ana Ruiz", "email": "ana@example.com", "amount": 49.99 }
• { "name": "Ben Carter", "email": "ben@example.com", "amount": 129.50 }
• { "name": "Carla Diaz", "email": "carla@example.com", "amount": 24.00 }
• { "name": "Dan Kim", "email": "dan@example.com", "amount": 89.95 }

C'est une structure plate et propre, donc la conversion est simple. Les noms des champs — name, email et amount — deviennent la ligne d'en-tête, et chaque objet devient une ligne du fichier CSV :

• name,email,amount
• Ana Ruiz,ana@example.com,49.99
• Ben Carter,ben@example.com,129.50
• Carla Diaz,carla@example.com,24.00
• Dan Kim,dan@example.com,89.95

Ouvrez ce fichier dans un tableur et vous obtiendrez un tableau ordonné de quatre lignes et trois colonnes, prêt à trier, filtrer ou totaliser. Additionnez les quatre montants — 49.99 plus 129.50 plus 24.00 plus 89.95 — et le total est 293.44, ce qui devrait correspondre au total de votre système de commandes. Si ce n'est pas le cas, cherchez un enregistrement manquant ou dupliqué.

Convertir JSON en CSV dans votre navigateur

Vous n'avez pas besoin d'installer de logiciel ni d'écrire de code pour convertir un fichier. Un convertisseur en ligne gratuit fait tout le travail : collez votre JSON, vérifiez l'aperçu et téléchargez le CSV. Le convertisseur JSON en CSV fonctionne entièrement dans votre navigateur, donc vos données ne quittent jamais votre ordinateur, ce qui compte quand le fichier contient des e-mails de clients ou des détails de commandes.

Le déroulement habituel prend moins d'une minute. D'abord, copiez le JSON depuis la réponse de votre API ou votre export. S'il ressemble à une seule ligne compressée, rangez-le d'abord avec un formateur JSON pour confirmer que la structure est valide. Collez-le ensuite dans le convertisseur, vérifiez les en-têtes de colonnes dans l'aperçu et téléchargez le CSV. Ouvrez le fichier téléchargé dans Excel ou Google Sheets et vérifiez trois choses : que les en-têtes correspondent aux champs attendus, qu'aucune colonne ne semble décalée, et que le nombre de lignes correspond au nombre d'enregistrements de votre JSON. Si quelque chose semble faux, le problème vient presque toujours de données imbriquées ou d'un champ manquant.

Questions fréquentes

Puis-je convertir JSON en CSV dans Excel sans outil en ligne ?

Oui. Dans Excel, utilisez Données, puis Obtenir des données, puis À partir d'un fichier, puis À partir de JSON pour charger le fichier via Power Query. Power Query affiche le JSON sous forme de tableau que vous pouvez développer, en aplatissant les enregistrements imbriqués en cliquant sur l'icône de développement d'une colonne. Une fois que le tableau a l'air correct, choisissez Fermer et charger, puis enregistrez le fichier au format CSV. Google Sheets n'a pas d'importation JSON intégrée, donc pour Sheets, un convertisseur en ligne est généralement plus rapide.

Que deviennent les tableaux imbriqués de mon JSON ?

Les tableaux imbriqués doivent être aplatis avant de devenir du CSV, car une seule cellule ne peut pas contenir une liste de valeurs de manière utile. La plupart des convertisseurs créent une ligne par élément du tableau, en répétant les champs de l'enregistrement parent, ou joignent les éléments dans une seule cellule avec un séparateur. Choisissez une ligne par élément quand vous devez compter, additionner ou filtrer les éléments, et une cellule jointe seulement quand vous avez besoin d'une ligne par enregistrement parent.

Pourquoi mon CSV semble cassé quand je l'ouvre dans Excel ?

Les causes les plus fréquentes sont les virgules sans guillemets dans le texte, un séparateur différent et l'encodage. Si une valeur contient une virgule et n'est pas entourée de guillemets, Excel la divise en colonnes supplémentaires. Si votre fichier utilise des points-virgules au lieu de virgules, Excel peut mettre toute la ligne dans une seule colonne ; l'importer via l'Assistant Importation de texte et choisir le bon délimiteur corrige cela. Si les caractères accentués semblent faux, réimportez et choisissez l'encodage UTF-8.

Vous savez maintenant comment convertir JSON en CSV comme il faut : choisissez les colonnes qui comptent, aplatissez les données imbriquées de manière cohérente, faites attention aux virgules et aux guillemets, et vérifiez le nombre de lignes et un total avant de partager le fichier. Essayez maintenant avec le convertisseur JSON en CSV gratuit : collez votre JSON, téléchargez un CSV propre prêt pour votre tableur, et revenez au travail qui compte vraiment.