O que é JSON-LD e como usar em dados estruturados
Por Tiago CostaAtualizado em 2 de julho de 2026
JSON-LD (JavaScript Object Notation for Linked Data) é o jeito recomendado de escrever dados estruturados. Na prática, ele:
- fica em um bloco de script separado, sem sujar o HTML visível;
- usa o vocabulário do Schema.org para rotular cada informação;
- diz ao Google se um trecho é um autor, um preço, uma nota ou uma data;
- habilita resultados ricos (estrelas, FAQ, imagem) na página de resultados.
O que é JSON-LD
JSON-LD é a sigla de JavaScript Object Notation for Linked Data, um formato para descrever dados de maneira que tanto humanos quanto máquinas consigam ler. No contexto de SEO, ele tem um papel bem específico: é a forma recomendada de inserir dados estruturados em uma página, dentro de um bloco de script.
A ideia central é dar significado explícito ao conteúdo. Para uma pessoa, a frase "artigo escrito por Ana Silva em 12 de maio" é clara. Para o buscador, é apenas texto. Com JSON-LD, você rotula "Ana Silva" como o autor (author) e a data como datePublished, e o Google passa a entender aquilo como metadados confiáveis, podendo exibir o autor e a data no resultado.
Vale separar dois sentidos. Para desenvolvedores, JSON-LD é um padrão do W3C usado em qualquer troca de dados conectados. Para quem faz SEO, ele é sobretudo o veículo do schema markup: o envelope onde o vocabulário do Schema.org é escrito para gerar resultados ricos.
Como o JSON-LD funciona
Um JSON-LD para SEO vive dentro de uma tag <script type="application/ld+json">, geralmente no head ou no fim do body da página. Por ficar isolado do HTML visível, ele não interfere no layout e é fácil de manter, que é justamente por que o Google o prefere.
Todo bloco começa com duas chaves obrigatórias. A propriedade @context aponta para o vocabulário usado (quase sempre Schema.org), e a propriedade @type define o que a página é (um Article, um Product, uma FAQPage). A partir daí, você preenche as propriedades daquele tipo, como name, author, price ou datePublished.
O fluxo é direto: o crawler rastreia a página, encontra o bloco JSON-LD, interpreta cada propriedade e, se o conteúdo estiver elegível, mostra um recurso enriquecido no resultado. Os mesmos dados também ajudam a alimentar o grafo de conhecimento, conectando entidades como pessoas, marcas e produtos.
JSON-LD, Microdata e RDFa: por que o Google prefere JSON-LD
O vocabulário do Schema.org pode ser escrito em três sintaxes diferentes. Entender as diferenças ajuda a escolher a que dá menos trabalho e menos erro.
| Formato | Onde fica | Manutenção |
|---|---|---|
| JSON-LD | Em um bloco de script separado do conteúdo. | Fácil, não depende do HTML visível. |
| Microdata | Em atributos espalhados nas tags do HTML. | Trabalhosa, quebra com mudanças de layout. |
| RDFa | Em atributos dentro das tags, como o Microdata. | Trabalhosa e mais verbosa. |
O Google recomenda oficialmente o JSON-LD justamente porque ele separa a marcação do conteúdo, como explica a documentação do Google Search Central. E o mercado seguiu esse caminho: segundo o Web Almanac 2024, do HTTP Archive, o JSON-LD já aparece em 41% das páginas analisadas (contra 34% em 2022) e é o formato que mais cresce.
Exemplo de JSON-LD na prática
Nada explica melhor do que ver o código. Abaixo, um exemplo mínimo de marcação de um artigo de blog com JSON-LD:
- @context: "https://schema.org", o vocabulário usado.
- @type: "Article", dizendo que a página é um artigo.
- headline: o título do artigo.
- author: um objeto do tipo Person com o nome de quem escreveu.
- datePublished: a data de publicação em formato ISO (por exemplo 2026-05-12).
Na prática, esse bloco entra dentro de uma tag de script no HTML. Cada tipo do Schema.org tem propriedades obrigatórias e recomendadas, e preencher também as recomendadas, não só o mínimo, aumenta bastante a chance de o resultado rico ser exibido. Um mesmo tipo de página costuma reutilizar o mesmo modelo de marcação, mudando apenas os valores.
Como criar e validar seu JSON-LD passo a passo
Você não precisa escrever tudo à mão. Um roteiro que funciona para a maioria dos sites:
- Escolha o tipo certo: identifique o que a página representa (um artigo, um produto, uma FAQ) e selecione o tipo correspondente no Schema.org.
- Gere o bloco: use um gerador de JSON-LD ou um plugin de SEO. Em plataformas como WordPress, extensões inserem a marcação automaticamente.
- Preencha com dados reais: nunca marque uma avaliação ou um preço que não existe na página, porque isso viola as diretrizes e pode gerar penalidade.
- Valide antes de publicar: rode o bloco no Teste de Resultados Ricos do Google e no validador do Schema.org para pegar erros e avisos.
- Monitore no Search Console: acompanhe o relatório de aprimoramentos para ver quais páginas estão elegíveis e corrigir problemas.
Depois de publicado, o buscador precisa rastrear a página de novo para reconhecer a marcação, então os resultados ricos podem levar alguns dias para aparecer.
JSON-LD, SEO e visibilidade em IA
O JSON-LD não é um fator direto de ranqueamento, mas trabalha a favor do SEO de duas formas. Primeiro, ele habilita resultados ricos, que ocupam mais espaço, chamam mais atenção e tendem a receber mais cliques. Segundo, ele deixa o conteúdo mais claro para a máquina, reduzindo a chance de o buscador interpretar a página errado.
Há ainda um ganho mais recente. Os buscadores generativos e os assistentes de IA usam a estrutura semântica para entender e citar conteúdo com mais confiança. Uma página bem marcada com JSON-LD tende a ser mais fácil de resumir e referenciar dentro dos AI Overviews, somando valor de SEO tradicional e de otimização para IA. Por ser leve, padronizado e recomendado pelo Google, o JSON-LD virou a base técnica de qualquer estratégia séria de SEO técnico.