JSON-LD

JSON-LD, del inglés JavaScript Object Notation for Linked Data, es una forma de incluir información estructurada sobre una página en el código, separada del texto visible. Va en un bloque de script aparte, normalmente en el head de la página, y describe con un formato fijo lo que hay en la página: una empresa, un producto, un artículo, un evento o una serie de preguntas frecuentes.

JSON-LD es el formato que recomienda Google para los datos estructurados. El vocabulario que usas en él viene de Schema.org, un estándar común de los grandes buscadores. JSON-LD es, por tanto, el envoltorio, y Schema.org el idioma.

¿Por qué elegir JSON-LD?

Existen otros formatos, como Microdata y RDFa, que se integran directamente en los elementos HTML. JSON-LD tiene la ventaja de ser independiente del maquetado. Puedes añadirlo o modificarlo sin tocar la página visible, lo que facilita el mantenimiento. En plataformas como Webflow o WordPress a menudo puedes configurarlo por tipo de página con campos dinámicos, para que cada página reciba automáticamente los datos correctos. En una tienda online con cientos de productos eso ahorra mucho trabajo manual, porque el precio y el stock salen directamente de los datos del producto.

¿Cómo se ve en la práctica?

Una pastelería de Valencia quiere decirles claramente a Google y a otros sistemas quién es. En JSON-LD se describe como tipo Bakery, con:

• el nombre oficial, la dirección y el teléfono, iguales a sus datos NAP en el resto de internet;
• el horario de apertura de cada día;
• la URL de su logo y algunas fotos;
• enlaces a sus perfiles en redes sociales mediante la propiedad sameAs.

En sus páginas de tartas por encargo también puede usar el marcado Product con precio y disponibilidad. Importante: todo lo que hay en el JSON-LD también debe verse en la propia página o ser correcto.

JSON-LD y las búsquedas con IA

Los datos estructurados ayudan a los buscadores a reconocer sin ambigüedad las entidades y sus propiedades. Eso encaja con cómo funciona un Knowledge Graph: como una red de entidades y sus relaciones. No está documentado públicamente hasta qué punto asistentes de IA como ChatGPT, Gemini o Perplexity usan JSON-LD directamente al redactar sus respuestas. No es, por tanto, una solución mágica para aparecer en la IA, pero sí una forma de ofrecer tus datos de la manera más inequívoca posible a cualquier sistema que los lea.

Errores frecuentes y cómo evitarlos

1. Marcado que no coincide con la página: reseñas o precios en el código que los visitantes no ven van en contra de las directrices de Google.
2. Errores de sintaxis: una sola coma que falta puede hacer ilegible todo el bloque. Pruébalo con la prueba de resultados enriquecidos de Google o con el validador de Schema.org.
3. Datos desactualizados: un horario que se ha cambiado en la web pero no en el JSON-LD.
4. Esperar que el marcado genere siempre un resultado llamativo: Google decide por sí mismo si muestra resultados enriquecidos.

Un análisis SEO técnico que revisa tus datos estructurados detecta JSON-LD que falta, erróneo o contradictorio, para que sepas dónde actuar primero.