Convertisseur JSON en CSV

Comment convertir du JSON en CSV en ligne

Le JSON est le format que renvoient la plupart des API, et il se prête naturellement au code : un objet peut contenir un autre objet, un tableau peut contenir des objets, sans que cela pose de problème pour un programme qui parcourt cette structure. Un tableur fonctionne différemment. Excel, Google Sheets et n'importe quel écran d'import CSV attendent une grille plate de lignes et de colonnes, alors dès qu'il faut transmettre des données JSON à quelqu'un qui travaille dans un tableur, quelqu'un doit remodeler ce format. C'est exactement ce que fait cet outil, entièrement dans votre navigateur, le temps de coller le texte et de cliquer sur un bouton.

La forme de l'entrée compte moins qu'on ne le pense. Vous pouvez coller un seul objet JSON, comme la réponse d'un unique appel API, ou un tableau d'objets, comme une liste de lignes de base de données exportée en JSON. Dans les deux cas, le convertisseur normalise ce que vous avez fourni en une liste d'enregistrements, détermine l'ensemble des colonnes nécessaires entre tous ces enregistrements, puis écrit un fichier CSV avec une ligne d'en-tête suivie d'une ligne par enregistrement.

Guide de conversion étape par étape

1. Collez votre JSON. Déposez un objet unique ou un tableau d'objets dans le champ « Entrée JSON ». Il peut provenir d'une réponse d'API, d'un export de base de données, d'un fichier de configuration ou de n'importe quelle autre source JSON.
2. Choisissez un délimiteur. La virgule est sélectionnée par défaut et convient à la plupart des tableurs en locale anglophone, mais le menu propose aussi Tabulation, Point-virgule et Barre verticale pour les cas décrits plus bas.
3. Décidez si vous souhaitez aplatir les objets imbriqués. Laissez « Aplatir les objets imbriqués » coché si votre JSON contient une hiérarchie que vous voulez voir éclatée en colonnes distinctes, comme un objet adresse ou un bloc de métadonnées.
4. Cliquez sur « Convertir en CSV ». L'outil analyse votre JSON, l'aplatit si demandé, rassemble tous les noms de colonnes uniques présents dans l'ensemble des enregistrements, et écrit le résultat dans le champ Sortie CSV en une fraction de seconde.
5. Copiez ou téléchargez le résultat. Utilisez le bouton Copier pour récupérer le texte CSV brut, ou « Télécharger le .csv » pour l'enregistrer en fichier que vous pourrez ouvrir directement dans Excel, Google Sheets ou LibreOffice Calc.

Rien de tout cela ne passe par un serveur. L'analyse, l'aplatissement et la mise en forme CSV s'exécutent tous en JavaScript sur votre propre appareil, si bien que la conversion fonctionne de la même façon que votre tableau contienne trois enregistrements ou trente mille, et que rien de ce que vous collez n'est jamais transmis ailleurs pour être traité.

Aplatir le JSON imbriqué : notation pointée et tableaux expliqués

Un tableur est fondamentalement à deux dimensions : des lignes et des colonnes, rien d'imbriqué à l'intérieur d'une cellule. Le JSON n'a pas cette contrainte, un objet peut contenir un autre objet, qui peut contenir un tableau, qui peut contenir d'autres objets, sur autant de niveaux que les données l'exigent. Convertir de l'un vers l'autre implique de prendre une décision pour chaque structure imbriquée de vos données, et cet outil applique un petit ensemble de règles prévisibles pour le faire.

Les objets imbriqués sont aplatis avec une notation pointée. À partir de {"user": {"profile": {"name": "Camille", "verified": true}}}, l'outil descend dans user, puis dans profile, et produit deux colonnes nommées user.profile.name et user.profile.verified. Il récurse sur autant de niveaux qu'il en trouve, si bien qu'une réponse d'API structurée sur quatre ou cinq niveaux finit malgré tout en une ligne plate de colonnes, au lieu d'un bloc de texte JSON illisible coincé dans une seule cellule.

Les tableaux se traitent différemment selon ce qu'ils contiennent. Un tableau de valeurs simples, comme "tags": ["admin", "moderator"], est rassemblé dans une seule cellule sous la forme admin;moderator plutôt que réparti sur plusieurs colonnes, car il n'existe pas de nom de colonne naturel pour « le troisième tag », et la plupart des listes de tags n'ont pas besoin d'être triées ou filtrées colonne par colonne. Un tableau d'objets, en revanche, comme une liste de lignes de commande, est développé avec une notation indexée : items[0].sku, items[0].price, items[1].sku, items[1].price, et ainsi de suite, de sorte qu'aucune donnée d'aucun élément du tableau ne se retrouve écrasée ou fusionnée dans une chaîne illisible.

Les données incohérentes sont traitées de la même façon, aussi désordonnées soient-elles. Avant d'écrire la moindre ligne, l'outil parcourt tous les objets de votre entrée et construit l'ensemble complet des noms de colonnes présents dans tout le jeu de données, pas seulement les clés du premier enregistrement. Si le cinquième enregistrement possède un champ absent des quatre premiers, ce champ obtient malgré tout sa propre colonne, et chaque ligne qui n'a pas de valeur pour cette colonne reçoit simplement une cellule vide plutôt que de décaler le reste du tableau.

Choisir un délimiteur : virgule, point-virgule, tabulation ou barre verticale

« CSV » signifie comma-separated values, valeurs séparées par des virgules, mais la virgule n'est en réalité qu'un choix par défaut, et se tromper de délimiteur est l'une des raisons les plus fréquentes pour lesquelles un fichier converti semble cassé dès qu'on l'ouvre. Cet outil propose quatre délimiteurs, chacun répondant à un besoin réel plutôt qu'existant pour le principe.

La distinction entre virgule et point-virgule perturbe plus de monde que n'importe quel autre réglage de cette page, car elle reste invisible tant que le fichier n'est pas déjà ouvert. En France, le format numérique standard écrit un nombre comme 1 234,56, avec une virgule comme séparateur décimal, et Excel en configuration française part donc du principe qu'une virgule appartient toujours à un nombre, jamais à une frontière de colonne. Si vous ouvrez un CSV délimité par des virgules dans un Excel réglé en français, il arrive fréquemment que tout le contenu s'entasse dans la seule colonne A, sans aucune séparation, parce qu'Excel cherche des points-virgules et considère chaque virgule comme une ponctuation ordinaire à l'intérieur d'une valeur plutôt que comme une limite de colonne. Basculer le délimiteur de cet outil sur point-virgule avant d'envoyer un fichier à un collègue ou un client francophone évite ce problème d'un bout à l'autre, sans qu'il ait à changer quoi que ce soit de son côté.

Guillemets et échappement : virgules, guillemets et retours à la ligne dans un champ

Une fois le délimiteur choisi, le convertisseur doit encore gérer les valeurs qui contiennent ce même caractère, ou un guillemet, ou un véritable saut de ligne, sans casser la structure de la ligne. Une description de produit du type "Disponible en rouge, bleu et vert" contient des virgules qui ne sont pas des séparateurs de colonnes, et un convertisseur naïf qui se contenterait de joindre les champs avec des virgules découperait cette seule description en trois colonnes distinctes et incohérentes.

Cet outil applique la règle standard de mise entre guillemets du CSV : un champ n'est entouré de guillemets doubles que lorsque c'est réellement nécessaire, c'est-à-dire lorsqu'il contient le caractère délimiteur, un guillemet double littéral, ou un saut de ligne. Tout le reste reste en texte simple, non mis entre guillemets, ce qui garde la sortie lisible et évite d'alourdir des valeurs simples comme des noms ou des nombres avec des guillemets inutiles.

• Délimiteur intégré au champ. Dupont, Marie devient "Dupont, Marie" lorsque le délimiteur est la virgule, afin que la virgule contenue dans le nom ne soit pas confondue avec une frontière de colonne.
• Guillemets intégrés au champ. Une valeur comme Il a dit "bonjour" devient "Il a dit ""bonjour""" : le champ entier est entouré de guillemets, et chaque guillemet interne est doublé afin qu'un tableur puisse le distinguer des guillemets qui marquent les limites du champ.
• Sauts de ligne intégrés au champ. Une adresse multi-lignes stockée comme une seule chaîne JSON, avec un véritable caractère de saut de ligne au milieu, est elle aussi entourée de guillemets. Le champ peut ainsi occuper plusieurs lignes dans le texte CSV brut tout en étant relu par n'importe quel tableur comme une seule cellule, et non comme deux lignes séparées.

Ce point compte surtout pour les données issues de champs de texte libre, avis clients, descriptions de produits ou champs de notes, où virgules, guillemets et sauts de ligne apparaissent constamment et sans prévenir. Bien gérer les guillemets dès le départ fait toute la différence entre un CSV qui s'ouvre proprement et un fichier où la moitié des lignes est décalée d'une colonne à cause d'une seule virgule mal placée.

UTF-8, le BOM et pourquoi les caractères accentués deviennent illisibles dans Excel

Un fichier CSV n'est qu'une suite d'octets ; rien dans le format lui-même ne déclare quel encodage de texte représentent ces octets. Cette ambiguïté ne se voit pas pour du texte en anglais limité aux lettres A à Z, mais elle devient un vrai problème dès qu'un nom, une ville ou une description contient un caractère accentué ou non latin, quelque chose comme François, Müller, Genève ou Chloé. Enregistrés puis relus avec des hypothèses d'encodage différentes, ces caractères ressortent sous forme de séquences illisibles, un peu comme François à la place du texte d'origine.

Une solution courante à ce problème est le BOM UTF-8, un marqueur d'ordre des octets composé de trois octets précis (EF BB BF) placés au tout début du fichier, qui indique à un programme compatible « ce fichier est en UTF-8, lisez-le ainsi » avant même le premier caractère de données réel. Excel sous Windows fait partie des programmes qui recherchent ce marqueur : un CSV en UTF-8 qui commence par ce BOM s'ouvre en général correctement en double-cliquant dessus, tandis que le même fichier sans BOM est souvent lu avec la page de codes locale du système à la place, corrompant silencieusement tout caractère accentué qu'il contient.

Il faut être clair sur ce que fait précisément ce convertisseur : le bouton de téléchargement de cet outil écrit un fichier CSV en UTF-8 simple, sans ajouter de BOM au début. Pour des données entièrement en anglais ou sans accents, cela ne change rien de visible. Pour des données contenant des noms accentués ou des noms de villes non anglophones, cela signifie que double-cliquer sur le fichier téléchargé peut afficher des caractères déformés dans Excel, même si le fichier sous-jacent est correctement encodé. La solution fiable, qui fonctionne indépendamment de cette question de BOM, consiste à éviter de double-cliquer sur le fichier et à passer plutôt par l'assistant d'import Données > Depuis un fichier texte/CSV d'Excel, qui vous permet d'indiquer explicitement « ce fichier est en UTF-8 » avant qu'Excel n'affiche la moindre cellule.

Ouvrir le résultat dans Excel, Google Sheets et LibreOffice Calc

Le même fichier CSV se comporte un peu différemment selon le tableur qui l'ouvre, principalement parce que chacun fait des hypothèses différentes par défaut sur le délimiteur et l'encodage.

Microsoft Excel

Double-cliquer sur un fichier .csv le confie à l'ouverture rapide d'Excel, qui devine le délimiteur à partir de vos paramètres régionaux Windows et devine l'encodage à partir de la page de codes du système plutôt que de vérifier s'il s'agit d'UTF-8. C'est rapide, mais c'est exactement ce chemin qui produit à la fois la confusion virgule/point-virgule et le charabia des caractères accentués décrits plus haut. La méthode la plus fiable reste l'assistant Données > Depuis un fichier texte/CSV, qui affiche un aperçu et permet de fixer l'origine du fichier sur UTF-8 et de confirmer le délimiteur avant que quoi que ce soit ne soit importé.

Google Sheets

Utilisez Fichier > Importer > Importer puis sélectionnez le fichier CSV. Google Sheets détecte nettement mieux qu'Excel en mode double-clic à la fois l'encodage UTF-8 et le délimiteur, si bien qu'un fichier délimité par des points-virgules ou des virgules issu de cet outil s'importe généralement sans réglage manuel, même si la boîte de dialogue d'import permet de forcer le séparateur si la détection automatique se trompe.

LibreOffice Calc

LibreOffice affiche une boîte de dialogue d'import de texte à chaque ouverture d'un fichier .csv, et pas seulement lorsqu'on le demande explicitement comme dans Excel. C'est un peu plus de friction pour un simple coup d'œil rapide, mais cela donne un contrôle manuel complet à chaque fois : un menu de jeu de caractères où choisir directement « Unicode (UTF-8) », et des cases à cocher pour la virgule, le point-virgule, la tabulation et les autres séparateurs, sans aucune ambiguïté sur la façon dont le fichier sera interprété.

Pourquoi ce convertisseur fonctionne entièrement dans votre navigateur

La plupart des outils « convertir JSON en CSV » que l'on trouve en ligne téléversent ce que vous collez vers un serveur, le traitent là-bas, puis renvoient le résultat. Cet aller-retour est invisible en usage normal, mais il signifie que vos données, même brièvement, ont séjourné sur une infrastructure que vous ne contrôlez pas. Pour un petit échantillon de données publiques, ce n'est pas un problème. Pour un export de véritables fiches clients, un dump interne de base de données, ou tout ce qui relève d'un accord de traitement de données, c'est une réelle préoccupation, et c'est exactement le genre de chose qu'une revue de sécurité signalerait immédiatement.

Ce convertisseur ne fait jamais ce trajet. L'analyse du JSON, l'aplatissement des objets imbriqués et la construction du CSV sont du JavaScript ordinaire, livré avec la page et exécuté sur votre appareil dès que vous cliquez sur Convertir. Ouvrez l'onglet réseau de votre navigateur pendant que vous l'utilisez, vous ne verrez aucune requête transporter vos données où que ce soit. Cela a aussi un effet pratique au-delà de la confidentialité : il n'y a ni file d'attente serveur à attendre, ni limite de débit d'API, ni plafond de taille imposé par un serveur, puisque c'est votre propre ordinateur qui fait tout le travail.

Ce que cela signifie pour les équipes qui gèrent des exports sensibles

Si vous convertissez un export de base de données, une liste de fiches utilisateurs, des lignes de contrat, ou tout ce que vous ne voudriez pas voir sortir de votre organisation, un outil purement local retire ce risque de l'équation plutôt que de vous demander de faire confiance à une politique de confidentialité que vous n'avez pas lue. C'est le même raisonnement qui pousse les équipes d'ingénierie à exécuter un formateur ou une transformation de données en local plutôt que de coller des données de production dans un formulaire web quelconque.

Cas d'usage courants de ce convertisseur JSON vers CSV

Déboguer et relire des réponses d'API

Un développeur récupère une réponse JSON d'un point d'accès REST et doit la transmettre dans un format lisible à une personne en test ou en gestion de produit qui travaille dans un tableur plutôt que dans les outils de développement du navigateur. Convertir la réponse ici transforme un mur d'accolades et de crochets en lignes et colonnes que toute l'équipe peut parcourir et filtrer.

Exporter des résultats de requêtes NoSQL

MongoDB, Firestore et les bases de données documentaires similaires renvoient par défaut leurs résultats de requête en JSON. Plutôt que d'écrire un script d'export ponctuel, coller un lot de résultats de requête dans cet outil produit un CSV qui s'ouvre directement dans Excel ou Sheets pour une analyse ponctuelle, un filtrage rapide ou un tableau croisé dynamique.

Préparer des flux produits et des catalogues

Les places de marché en ligne et les plateformes marketing exigent souvent un CSV pour les imports groupés de produits, alors que les données produit elles-mêmes vivent dans un flux ou une API JSON. Convertir un export JSON d'un catalogue produit, y compris des champs imbriqués comme des paliers de prix ou des attributs de variantes, évite de reconstruire un tableur à la main.

Analyse de journaux structurés

Les applications qui émettent des journaux structurés en JSON produisent des données faciles à analyser pour une machine mais fastidieuses à parcourir visuellement. Coller un lot d'entrées de journal dans cet outil et les aplatir en colonnes permet de trier bien plus facilement par horodatage, de filtrer par code de statut, ou de repérer un schéma récurrent parmi des centaines d'entrées.

Migration de données entre systèmes

Passer d'une plateforme à une autre implique souvent que le système source exporte du JSON alors que le système de destination n'accepte que des imports CSV. Convertir l'export ici, vérifier les en-têtes de colonnes produits par l'aplatissement, puis ajuster les noms de champs si nécessaire, se révèle généralement plus rapide que d'écrire un script jetable pour une migration ponctuelle.

Conseils pour une sortie CSV propre et pièges courants

• Attention à l'explosion du nombre de colonnes avec de longs tableaux d'objets. Si un enregistrement possède un tableau de cinquante lignes de commande et qu'un autre n'en a que trois, l'aplatissement produit jusqu'à cinquante jeux de colonnes items[N].champ, la plupart vides pour les enregistrements les plus courts. Quand la longueur des tableaux varie beaucoup d'un enregistrement à l'autre, envisagez de décocher « Aplatir les objets imbriqués » pour que chaque tableau reste une seule chaîne JSON dans une seule cellule.
• Nombres qui doivent rester du texte. Un code postal, un numéro de téléphone ou un identifiant stocké comme une chaîne JSON, par exemple "00501", passe dans le CSV comme du texte et conserve son zéro initial. Si Excel reformate ensuite cette colonne en nombre et supprime le zéro de tête tout seul, définissez le format de la colonne en Texte avant ou pendant l'import plutôt qu'après.
• Les valeurs nulles et absentes deviennent des cellules vides, pas le mot « null ». Cela garde le CSV propre pour le tri et le filtrage, mais cela signifie aussi qu'on ne peut plus distinguer visuellement « explicitement défini à null » de « la clé était absente » une fois les données passées en tableur ; si cette distinction compte, vérifiez le JSON source avant de convertir.
• Revérifiez le délimiteur après avoir collé un nouveau jeu de données. Le menu déroulant reste sur votre dernier choix, donc si vous avez converti un fichier délimité par des points-virgules pour un collègue puis collé un nouveau jeu de données, mieux vaut confirmer que le délimiteur correspond toujours à qui, ou quoi, ouvrira le prochain fichier.
• Les très grands tableaux passent bien, surveillez simplement votre onglet. Aucune limite n'est imposée par l'outil lui-même, mais un tableau JSON de plusieurs dizaines de milliers d'enregistrements profondément imbriqués consommera nettement plus de mémoire qu'un petit jeu de données ; si l'onglet devient poussif, convertir les données par lots plus petits fonctionne tout aussi bien.

La plupart des sorties CSV qui semblent fausses viennent de l'un de ces cinq points plutôt que d'un bug dans la logique de conversion elle-même : une longueur de tableau incohérente, un nombre qui aurait dû rester du texte, un délimiteur qui ne correspond pas à ce qu'attend le destinataire, ou un problème d'encodage à l'ouverture du fichier. Vérifier le champ Sortie CSV avant de télécharger, en particulier la ligne d'en-tête, reste le moyen le plus rapide de repérer l'un de ces problèmes tôt.

Questions Fréquentes

Outils de conversion de données associés

🔒 Confidentialité 100% Locale

L'analyse JSON et la génération du CSV se déroulent <strong>entièrement dans votre navigateur</strong>. Aucune donnée n'est jamais envoyée à un serveur. Votre JSON reste sur votre appareil à tout moment.