Aller au contenu
Aback Tools Logo

Comment Vérifier les Données Structurées d’un Site : Guide de Validation JSON-LD

Comment vérifier les données structurées d’un site : trouver les blocs JSON-LD, valider la syntaxe et les propriétés obligatoires, corriger les erreurs de schéma courantes, tester l’éligibilité aux résultats enrichis et automatiser la validation en CI/CD.

DH
Tutorials & How-Tos12 min de lecture2,700 mots

Les données structurées indiquent aux moteurs de recherche ce que signifie votre contenu — pas seulement ce que disent les mots, mais si une page est un produit, un article, une recette ou une FAQ. Bien fait, Google met en avant votre contenu sous forme de résultats enrichis : notes en étoiles, accordéons FAQ, fils d’Ariane et carrousels d’étapes. Mal fait, le balisage est ignoré en silence. Ce guide couvre toutes les méthodes pour vérifier les données structurées de n’importe quel site, de l’inspection du code source à la validation automatisée en CI.

40+Types de schémapris en charge par les résultats enrichis Google
100%Vérification locale navigateursans URL ni connexion
<1sVitesse de validationretour JSON-LD instantané

Qu’est-ce que les données structurées ?

Les données structurées sont des métadonnées lisibles par machine intégrées à une page web qui aident les moteurs de recherche à comprendre le contenu au-delà du texte visible. Le format dominant est JSON-LD — une balise script en notation objet JavaScript placée dans le `<head>` d’une page, utilisant le vocabulaire de schema.org pour décrire des entités comme des articles, produits, événements, recettes et organisations.

Quand un moteur de recherche explore une page, il extrait ces blocs de schéma et les utilise pour générer des résultats enrichis : des listings de recherche améliorés affichant notes en étoiles, fourchettes de prix, dates d’événements, accordéons FAQ et navigation fil d’Ariane directement dans la SERP. Les résultats enrichis obtiennent constamment des taux de clic supérieurs aux listings standard au lien bleu, car ils transmettent plus d’informations d’un coup d’œil.

Les trois formats de données structurées

  • JSON-LD : une balise `<script type="application/ld+json">` autonome contenant un objet JSON. Google recommande ce format — le plus simple à ajouter, valider et maintenir sans toucher au HTML de la page.
  • Microdata : attributs de schéma (`itemscope`, `itemtype`, `itemprop`) ajoutés directement aux éléments HTML. Fortement couplés à la structure de la page — plus difficiles à valider et mettre à jour.
  • RDFa : attributs de données liées (`typeof`, `property`) ajoutés aux éléments HTML. Très utilisé sur certains CMS mais moins répandu que JSON-LD pour les nouvelles implémentations.

Note

Google prend en charge les trois formats, mais recommande JSON-LD pour la plupart des usages. Ce guide se concentre sur JSON-LD car c’est le format dominant des implémentations modernes et celui autour duquel la plupart des outils sont conçus.

Comment vérifier les données structurées

Il existe quatre méthodes pratiques pour vérifier les données structurées d’une page, chacune adaptée à des situations différentes. Les méthodes les plus rapides ne requièrent aucun outil ; les plus approfondies nécessitent un validateur et l’environnement de test de Google.

Méthode 1 : afficher le code source

Faites un clic droit sur n’importe quelle page dans le navigateur et choisissez Afficher le code source (Ctrl+U / Cmd+U). Appuyez sur Ctrl+F pour ouvrir la recherche et cherchez `application/ld+json`. Chaque résultat est un bloc de données structurées. Cela vous indique immédiatement si des données structurées existent sur la page et permet de copier le JSON pour validation. Pour les pages rendant le contenu en JavaScript, le code source ne montre que le HTML initial — utilisez les DevTools pour la sortie rendue.

Méthode 2 : panneau Elements des DevTools

Ouvrez les DevTools Chrome (F12), allez dans l’onglet Elements et cherchez `ld+json` dans l’arbre d’éléments. Cela montre les données structurées telles que le navigateur les rend actuellement — y compris les blocs injectés en JavaScript après le chargement. C’est l’approche correcte pour React, Next.js ou tout framework ajoutant les données structurées côté client ou via le rendu serveur.

Méthode 3 : Validateur de Données Structurées (le plus rapide en développement)

Copiez un bloc JSON-LD et collez-le dans le validateur de données structurées. Il valide la syntaxe JSON, vérifie les déclarations `@context` et `@type`, et signale les propriétés obligatoires manquantes pour le type de schéma déclaré — tout dans votre navigateur, sans soumettre d’URL ni attendre un crawl. C’est la boucle la plus rapide en développement : corriger et revalider prend quelques secondes.

Méthode 4 : le Test de Résultats Enrichis de Google

Soumettez l’URL de votre page en ligne au Test de Résultats Enrichis de Google sur `search.google.com/test/rich-results`. Google récupère la page, extrait toutes les données structurées et indique les types de résultats enrichis auxquels la page est éligible. C’est le test faisant autorité pour l’éligibilité aux résultats enrichis — mais il requiert une URL en ligne et prend 5-30 secondes par test. Utilisez-le une fois la validation locale propre.

Validateur de Données Structurées

Validez tout bloc de données structurées JSON-LD pour la syntaxe, les propriétés obligatoires et la conformité schema.org — en local dans le navigateur, sans URL.

Open tool

Valider le balisage JSON-LD

La validation JSON-LD comporte deux niveaux distincts : la validation syntaxique (le JSON est-il structurellement valide ?) et la validation de schéma (le contenu se conforme-t-il aux propriétés obligatoires et recommandées du type schema.org ?). Les deux niveaux doivent passer avant qu’un bloc de données structurées soit utile.

1

Inspecter la page à la recherche de blocs JSON-LD

Faites un clic droit sur la page et choisissez Afficher le code source. Cherchez `application/ld+json`. Copiez l’objet JSON entier à l’intérieur de la balise script — de l’accolade ouvrante à l’accolade fermante. S’il y a plusieurs blocs, copiez chacun séparément pour validation.

2

Valider la syntaxe avec le validateur JSON-LD

Collez le bloc copié dans le validateur JSON-LD. Il vérifie que le JSON est bien formé, que `@context` vaut `https://schema.org` et que `@type` référence un type schema.org reconnu. Les erreurs de syntaxe sont signalées avec numéros de ligne ; les avertissements de type inconnu identifient les types de schéma peu susceptibles de produire des résultats enrichis.

3

Vérifier les propriétés obligatoires du type déclaré

Chaque type de schéma a des propriétés obligatoires et recommandées. Un schéma `Product` exige `name` et `offers` ou `review` pour l’éligibilité aux résultats enrichis. Un `Article` exige `headline`, `author` et `datePublished`. Le validateur de données structurées vérifie le `@type` déclaré et signale chaque propriété obligatoire manquante ou mal formatée.

4

Tester l’éligibilité avec l’outil de Google

Une fois la validation locale propre, soumettez l’URL de la page au Test de Résultats Enrichis de Google. Passez en revue la liste des types de schéma détectés et confirmez que chacun apparaît comme éligible plutôt que signalé avec des erreurs. Traitez les avertissements « Recommandé » pour les propriétés qui améliorent la qualité des résultats enrichis sans les bloquer.

exemple-schema-article.json
json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Check Structured Data on a Website",
  "author": {
    "@type": "Person",
    "name": "Devvrat Hans",
    "url": "https://abacktools.com"
  },
  "datePublished": "2026-06-11",
  "dateModified": "2026-06-11",
  "publisher": {
    "@type": "Organization",
    "name": "Aback Tools",
    "url": "https://abacktools.com"
  }
}

Tip

Définissez toujours `datePublished` et `dateModified` comme chaînes de date ISO 8601 (`YYYY-MM-DD` ou `YYYY-MM-DDTHH:MM:SSZ`). Une erreur fréquente : un format lisible comme « 11 juin 2026 » — cela échoue à la validation de schéma et peut empêcher l’article d’apparaître dans Google Discover et Top Stories.

Erreurs de données structurées courantes

La plupart des erreurs de données structurées tombent dans des catégories prévisibles. Savoir ce que signifie chaque type d’erreur — et pourquoi il compte — permet de corriger dans le bon ordre : d’abord la syntaxe, ensuite les propriétés obligatoires, enfin les améliorations recommandées.

Propriétés obligatoires manquantes

Google définit des propriétés obligatoires pour chaque type de schéma prenant en charge les résultats enrichis. Si une propriété obligatoire est absente, tout le schéma est inéligible à sa fonction de résultat enrichi. Exemples courants : `Product` sans `name` ni `offers`, `Recipe` sans `name` ni `recipeIngredient`, `Event` sans `name`, `startDate` ou `location`. Le vérificateur de complétude de schéma Product audite spécifiquement les schémas Product sur tous les champs Google obligatoires et recommandés.

Types de valeur incorrects

Les propriétés schema.org attendent des types de valeur spécifiques. Les propriétés `url` doivent être des URL absolues commençant par `https://` ; `ratingValue` doit être un nombre (pas une chaîne comme `"4.5"`) ; `datePublished` doit être une chaîne de date ISO 8601 valide. Passer une chaîne là où un nombre est attendu, ou un chemin relatif là où une URL absolue est requise, provoque une erreur d’incompatibilité de type qui empêche la lecture correcte du schéma.

Type de schéma et contenu de page incompatibles

Google exige que les données structurées reflètent fidèlement le contenu visible de la page. Placer un balisage `FAQPage` sur une page n’affichant pas visiblement de questions-réponses, ou ajouter un balisage `Product` à une page de catégorie sans détails produit spécifiques, enfreint les consignes de données structurées de Google et peut entraîner des actions manuelles contre l’éligibilité aux résultats enrichis.

Type d’erreurExempleImpactComment corriger
Propriété obligatoire manquanteProduct sans nameBloque le résultat enrichiAjouter la propriété
Type de valeur erronératingValue : "4.5" (chaîne)Schéma ignoréUtiliser un nombre : 4.5
URL relative dans un champ urlimage : /photo.jpgErreur de validationUtiliser une URL HTTPS absolue
Format de date invalidedatePublished : "juin 2026"Date non analyséeUtiliser le format YYYY-MM-DD
@type inconnu@type : "BlogPosting2"Schéma non reconnuUtiliser le type schema.org exact
@context manquantAucune déclaration @contextSchéma non extraitAjouter le contexte schema.org
Contenu incompatibleFAQPage sur une page non-FAQRisque d’action manuelleAdapter le schéma au contenu

Warning

Les politiques de Données Structurées de Google interdisent d’utiliser les données structurées pour baliser du contenu non visible par l’utilisateur. Les données structurées cachées — descriptions plus riches que le contenu visible, faux avis, ou données d’entité fabriquées pour le SEO — sont traitées comme du spam. Assurez-vous toujours que votre JSON-LD reflète ce que les utilisateurs voient réellement sur la page.

Vérification par type de schéma

Les différents types de schéma ont des propriétés obligatoires différentes, des présentations de résultats enrichis différentes et des outils de validation qui leur conviennent le mieux. Voici comment aborder les types les plus couramment utilisés.

FAQPage et HowTo

FAQPage est l’un des types de schéma les plus impactants pour le CTR organique — un schéma FAQPage valide se rend en accordéon dépliable directement dans les résultats Google, montrant questions et réponses sans clic. Utilisez le générateur de schéma FAQ pour produire un balisage FAQPage propre à partir de paires question-réponse, puis validez la sortie avec le validateur JSON-LD. Pour le contenu instructif étape par étape, le générateur de schéma HowTo construit un balisage HowTo valide avec des blocs `HowToStep` correctement structurés.

Le balisage BreadcrumbList génère le fil d’Ariane affiché sous le titre de la page dans les résultats Google — remplaçant l’URL brute par une hiérarchie lisible. Chaque `ListItem` exige un `name` et une URL `item`. Utilisez le générateur de schéma Breadcrumb pour générer du JSON-LD BreadcrumbList depuis un chemin d’URL ou des entrées manuelles, prêt à insérer directement dans votre gabarit de page.

Organization et Article

Le schéma Organization établit l’identité de votre site pour le graphe de connaissance de Google — nom, logo, coordonnées et profils sociaux. Le validateur de schéma Organization vérifie que tous les champs recommandés sont présents et correctement formatés. Pour le contenu éditorial, le schéma Article avec `author`, `datePublished` et `publisher` augmente l’éligibilité à Google News, Top Stories et Discover, qui peuvent apporter un trafic significatif aux pages d’actualités et de blog.

Avis et notes agrégées

Les notes en étoiles dans les résultats proviennent d’`AggregateRating` imbriqué dans un schéma `Product`, `LocalBusiness` ou `Recipe`. Le `ratingValue` doit être un nombre, `reviewCount` un entier positif, et `bestRating` comme `worstRating` doivent être précisés pour éviter toute ambiguïté. Le vérificateur d’éligibilité des extraits d’avis valide le balisage de notes face aux exigences spécifiques de Google pour les résultats enrichis d’avis.


Type de schémaRésultat enrichiChamps obligatoires clésVérificateur Aback Tools
FAQPageAccordéon FAQ en SERPmainEntity avec Q&RGénérateur de schéma FAQ
HowToCarrousel d’étapes en SERPname, step, textGénérateur de schéma HowTo
BreadcrumbListFil d’Ariane en SERPitemListElement, name, itemGénérateur de schéma Breadcrumb
ProductPanneau produit avec prix/notename, offers ou reviewVérificateur de complétude Product
ArticleTop Stories, Discoverheadline, author, datePublishedValidateur JSON-LD
OrganizationPanneau de connaissancesname, url, logoValidateur de schéma Organization
LocalBusinessPack local, cartesname, address, telephoneValidateur de données structurées

Données structurées en CI/CD

Les vérifications manuelles conviennent aux pages individuelles, mais les grands sites dont les gabarits génèrent les données structurées par programme ont besoin d’une validation automatisée. Ajouter une vérification de données structurées à votre pipeline CI/CD intercepte les régressions avant la production et avant qu’elles ne bloquent l’éligibilité aux résultats enrichis.

Extraction et validation dans les pipelines de build

L’approche la plus fiable est d’extraire le JSON-LD de votre HTML généré et de le valider par programme. Après un build, parsez les fichiers HTML produits, extrayez chaque bloc `<script type="application/ld+json">` et passez-les dans une bibliothèque de validation schema.org comme `schema-dts` (TypeScript), `jsonld` (Node.js) ou le Structured Data Linter de Google. Faites échouer le build si une propriété obligatoire manque ou si le JSON est malformé.

terminal
bash
# Extract all JSON-LD blocks from built HTML using grep
grep -rl 'application/ld+json' ./out/ | while read file; do
  # Parse and validate each block
  node scripts/validate-schema.js "$file"
done

# Or use a dedicated CLI tool
npx schema-validator ./out/**/*.html --strict

Surveillance des fonctionnalités SERP

Après déploiement, surveillez la performance des résultats enrichis dans Google Search Console, section « Améliorations ». Chaque type de schéma implémenté reçoit son propre rapport montrant éléments valides, avertissements et erreurs au fil des crawls de Googlebot. Un pic soudain d’erreurs signale généralement un changement de gabarit qui a cassé le schéma d’une catégorie entière de pages. Le vérificateur de fonctionnalités SERP offre une vue complémentaire — quelles fonctionnalités SERP une URL donnée déclenche actuellement.

Tip

Après avoir corrigé une erreur de données structurées, demandez la réindexation des URL affectées dans Google Search Console via l’outil d’inspection d’URL. Cliquez sur « Demander l’indexation » pour demander à Googlebot de recrawler et réextraire les données structurées plus tôt que le cycle normal de crawl, qui peut prendre des jours ou des semaines pour les pages moins prioritaires.

Bonnes pratiques

Suivre ces pratiques garantit que vos données structurées sont correctes, maintenables et alignées avec les consignes de Google — maximisant l’éligibilité aux résultats enrichis sans risquer d’actions manuelles ni d’échecs silencieux de schéma.

Garder les données structurées synchronisées avec le contenu visible

La source la plus fréquente d’actions manuelles de Google contre les données structurées est une incohérence entre le schéma et ce que voient les utilisateurs. Si votre schéma `Product` affiche un prix de 29 $ alors que la page montre 49 $, Google le considère comme un balisage trompeur. Utilisez votre CMS ou système de gabarits pour générer les données structurées depuis la même source de données qui remplit le contenu visible — ne codez jamais en dur des valeurs de schéma affichées dynamiquement ailleurs.

Utiliser des types spécifiques, pas génériques

Schema.org possède une hiérarchie de types profonde. Une page sur un produit logiciel devrait utiliser `SoftwareApplication`, pas le générique `Product`. Un restaurant local devrait utiliser `Restaurant` (sous-type de `FoodEstablishment`), pas le générique `LocalBusiness`. Des types plus spécifiques donnent plus de signal aux moteurs sur le contenu et peuvent débloquer des formats de présentation plus riches dans les résultats.

Les données structurées ne doivent pas être utilisées pour tromper les utilisateurs ni fournir d’informations trompeuses. Les données structurées d’une page doivent représenter fidèlement le contenu de la page.

- Documentation Google Search Central
  • Valider avant déploiement : exécutez le validateur de données structurées sur chaque bloc de schéma avant sa mise en ligne — attrapez les erreurs avant Googlebot.
  • Une entité par bloc : imbriquez les entités liées (ex. `author` dans `Article`) plutôt que de créer des blocs de premier niveau séparés pour chaque sous-entité.
  • URL absolues partout : les champs `url`, `image`, `logo` et `sameAs` exigent tous des URL `https://` complètes — les chemins relatifs sont invalides en données structurées.
  • Inclure sameAs pour les organisations : reliez votre schéma Organization à Wikipédia, Wikidata, LinkedIn et d’autres sources faisant autorité pour renforcer l’association au graphe de connaissance.
  • Surveiller Google Search Console : consultez chaque semaine les rapports Améliorations — ils montrent quelles pages ont des données structurées valides, avec avertissements ou erreurs au fil des crawls de Googlebot.

Note

Les données structurées sont lues par plus que Google. Microsoft Bing, les Rich Pins de Pinterest et les aperçus de liens Slack utilisent tous les données structurées schema.org pour leurs affichages enrichis. Une stratégie de schéma bien implémentée profite à toute plateforme consommant vos pages, pas seulement à la Recherche Google.

Key takeaways

  • Vérifiez les données structurées en cherchant `application/ld+json` dans le code source de la page — chaque balise script de ce type est un bloc de données structurées.
  • Utilisez le validateur de données structurées en développement pour une validation JSON-LD instantanée et locale, sans soumission d’URL.
  • Le Test de Résultats Enrichis de Google est l’outil faisant autorité pour l’éligibilité — exécutez-le une fois la validation locale propre, pas à sa place.
  • Les erreurs les plus courantes : propriétés obligatoires manquantes, types de valeur incorrects (chaînes là où des nombres sont attendus) et URL relatives là où des URL HTTPS absolues sont requises.
  • Générez un balisage de schéma correct pour les types FAQPage, HowTo, BreadcrumbList et Product grâce aux générateurs et validateurs dédiés d’Aback Tools.
  • Les données structurées doivent correspondre au contenu visible — les incohérences entre valeurs de schéma et valeurs affichées risquent des actions manuelles de Google contre l’éligibilité.
  • Surveillez la section Améliorations de Google Search Console après déploiement pour suivre éléments valides, avertissements et erreurs au fil des crawls de Googlebot.

Questions fréquentes

The fastest way is to right-click the page, select View Page Source, and search for "application/ld+json". Each script tag with that type contains a structured data block. Alternatively, open Chrome DevTools, go to the Network tab, reload the page, find the HTML document response, and search for "schema.org" in the response body. For a visual summary, use a browser extension like Schema Markup Validator or submit the URL to Google's Rich Results Test.

Google's Rich Results Test (search.google.com/test/rich-results) is the authoritative tool for checking rich result eligibility - it shows exactly which features your markup qualifies for. For faster, privacy-first validation without submitting a URL, the Aback Tools Structured Data Validator checks your JSON-LD block entirely in the browser with line-level error reporting. Use both: the Aback Tools validator during development and Google's tool before deployment.

JSON-LD (JavaScript Object Notation for Linked Data) is the W3C standard format for embedding structured data in web pages. You place a `<script type="application/ld+json">` tag in the `<head>` of your HTML document containing a JSON object that describes the page content using schema.org vocabulary. Google, Bing, and other search engines read this script tag to understand the page and generate rich results - star ratings, FAQ accordions, recipe cards, and breadcrumb trails in search results.

The most frequent errors are missing required properties (a `Product` schema without `name` or `offers`, an `Article` without `headline`), incorrect value types (a number where a URL is expected), invalid enum values (a `priceValidUntil` date in the wrong format), missing `@context` or `@type` declarations, and mismatched types (using `FAQPage` markup on a page that is not an FAQ page). Google also flags "soft errors" - missing recommended properties that do not block rich results but reduce their quality.

Structured data does not directly improve rankings - Google has stated it is not a ranking signal. Its value is in rich result eligibility: pages with correct structured data can appear as FAQ accordions, product panels with ratings and price, event listings, recipe cards, and How-to carousels in Google Search. These rich features increase click-through rate significantly, which has an indirect positive effect on organic performance. Structured data is also used by Google's AI Overviews for sourcing cited information.

Copy the JSON-LD block from your template or build output and paste it into the Aback Tools Structured Data Validator - it validates the schema without needing a live URL. For full rich-result eligibility testing, Google's Rich Results Test accepts either a URL or raw HTML - paste the entire `<head>` section of your page into the code input and it will extract and validate the structured data without the page being publicly accessible.

Yes. A page can have multiple `<script type="application/ld+json">` tags, each containing a separate schema type. A blog post page might include an Article schema, a BreadcrumbList schema, and an FAQPage schema simultaneously. Google reads all of them independently and applies whichever rich result features each schema qualifies for. The schemas must not contradict each other - the page name, URL, and author should be consistent across all blocks on the same page.

All three are formats for embedding structured data in HTML, but they differ in approach. JSON-LD places the schema in a standalone script tag, separate from the visible HTML - making it easy to add, maintain, and validate without touching the page content. Microdata and RDFa annotate existing HTML elements with schema attributes, tightly coupling the markup to the page structure. Google supports all three formats, but officially recommends JSON-LD for most use cases because it is the easiest to implement and maintain.

ShareXLinkedIn