Dados estruturados: o que o JSON-LD faz e o que não garante

Dado estruturado é um bloco de código que descreve a página em termos que o buscador entende sem interpretar a prosa: isto é um artigo, publicado nesta data, escrito por esta pessoa. O formato que o Google recomenda é o JSON-LD, por ser o mais fácil de manter (Central da Pesquisa Google, introdução aos dados estruturados). A marcação torna a página elegível para um resultado aprimorado, mas não garante que ele apareça. E ela só vale quando descreve o que a pessoa vê na tela.

Vocabulário e formato são coisas diferentes

Há duas peças em jogo. O vocabulário diz que tipos e propriedades existem, como Article, Offer e datePublished. Quase todo dado estruturado usado pela Pesquisa Google vem do schema.org (em inglês), um vocabulário criado por Google, Microsoft, Yahoo e Yandex e mantido hoje por uma comunidade aberta.

O formato diz como esse vocabulário entra no HTML. O Google aceita três (Central da Pesquisa Google):

JSON-LD, um bloco <script type="application/ld+json"> separado do texto visível. É o recomendado.
Microdata, atributos espalhados nas próprias tags do corpo.
RDFa, também por atributos, ligados ao conteúdo visível.

Para o Google, os três valem o mesmo quando a marcação é válida. A vantagem do JSON-LD é prática: como não se mistura com o texto, fica mais fácil aninhar um item dentro de outro e mais difícil quebrar a marcação ao editar a página. O Google também lê o JSON-LD quando ele é injetado por JavaScript (Central da Pesquisa Google).

O que ele pode render

O ganho direto é o resultado aprimorado, que a documentação em português chama de pesquisa aprimorada: um resultado de busca com mais informação que o link azul, como nota, preço, trilha de navegação ou imagem maior. A galeria de recursos da Pesquisa Google lista quais tipos têm exibição própria.

O Google publica casos de quem adotou a marcação. O Rotten Tomatoes marcou 100 mil páginas e mediu taxa de cliques 25% maior nelas do que nas páginas sem marcação. A Nestlé mediu taxa de cliques 82% maior nas páginas que apareceram como resultado aprimorado (Central da Pesquisa Google, introdução aos dados estruturados). São números contados pelas próprias empresas ao Google, sem o desenho do teste ao lado. Servem de sinal de que vale tentar, não de previsão para outro site.

O NN/g, o Nielsen Norman Group, ajuda a entender o porquê, embora não meça o dado estruturado em si. O instituto estuda os elementos especiais da página de resultados, aqueles que fogem do link azul comum. Numa análise de 471 buscas feitas entre 2017 e 2019, esses elementos receberam olhares em 74% dos casos em que apareceram (Kate Moran e Cami Goray, NN/g (em inglês)). O olho deixou de descer a lista em ordem e passou a pular entre o que se destaca.

Moran e Goray apontam quatro papéis para esses elementos (NN/g, três elementos da página de resultados (em inglês)). Eles servem de placa, porque a imagem confirma depressa que o resultado é sobre a coisa certa. Puxam a atenção, mudam a pergunta e às vezes já trazem a resposta.

Há também um ganho menos visível. O Google usa a marcação para entender a página e para reunir informação sobre pessoas, empresas e livros citados nela (Central da Pesquisa Google). Segundo a mesma página, propriedades do schema.org que o Google não exige podem servir a outros buscadores e ferramentas.

O que ele não garante

A diretriz geral do Google é direta: marcar certo, mesmo passando no teste, não garante que o resultado aprimorado apareça. A marcação deixa o recurso disponível, e o algoritmo decide se mostra. Ele pesa o histórico de busca, o lugar e o aparelho de quem pesquisa, e às vezes prefere o resultado só de texto.

O recurso também pode deixar de existir. Em junho de 2025, o Google anunciou o fim da exibição de sete tipos pouco usados na busca, entre eles informações sobre o curso, análise de declaração e informações sobre o veículo (Blog da Central da Pesquisa Google). O mesmo aviso diz que a mudança não afeta a classificação das páginas, e que o uso desses tipos fora da Pesquisa Google continua igual. O texto sobre perguntas frequentes conta um corte parecido, o do FAQPage.

Marcação errada tem custo, mas ele é limitado. Um problema de dado estruturado pode gerar uma ação manual, e a página perde a elegibilidade para o resultado aprimorado. Segundo o Google, isso não muda a posição dela na busca comum (diretrizes gerais).

As regras que o Google cobra

Parte das regras é técnica e um teste automático pega. A outra parte é de qualidade, e nenhuma ferramenta confere por você. As principais, das diretrizes gerais de dados estruturados:

Só o que está na tela. Se o JSON-LD descreve um artista, o corpo da página precisa falar desse artista. Informação invisível fica de fora, mesmo correta.
Retrato fiel da página. O exemplo do Google é o site de marcenaria que marca instruções como receita. O código pode ser válido, e o dado continua irrelevante.
Propriedades obrigatórias completas. Item sem uma propriedade exigida pelo tipo não entra no resultado aprimorado.
O tipo mais específico. Entre dois tipos do schema.org que servem, use o mais preciso.
Na página que ele descreve. A marcação mora na própria página, e não numa página vazia criada só para ela.
Acesso liberado. Página bloqueada por robots.txt ou noindex não tem a marcação lida.

Mais propriedades nem sempre é melhor. A introdução do Google prefere poucas propriedades recomendadas, completas e corretas, a todas preenchidas com dado mal formado.

Quando a página tem mais de um item, como um artigo e a trilha de navegação, eles podem vir aninhados ou separados. Se dois itens separados falam da mesma coisa, o @id liga um ao outro (Central da Pesquisa Google).

Data com fuso horário

Data de artigo é um detalhe que costuma sair errado. A documentação de artigo do Google espera datePublished e dateModified no formato ISO 8601 e recomenda informar o fuso. Sem ele, o Google usa o fuso do próprio robô, e a hora registrada pode não ser a que o site quis dizer.

Como conferir antes e depois de publicar

O Google indica um caminho em três momentos (introdução aos dados estruturados):

Durante o desenvolvimento, o Teste de pesquisa aprimorada valida a marcação e, em alguns casos, mostra uma prévia.
Depois de publicar, os relatórios de status de pesquisa aprimorada acompanham as páginas no Search Console, o painel do Google para donos de site. A marcação pode quebrar depois, por um problema no modelo da página.
Para medir efeito, compare páginas antes e depois por alguns meses no relatório de desempenho. Escolha páginas estáveis, que não dependam da época do ano.

Para conferir a marcação contra o vocabulário do schema.org em geral, sem olhar recurso do Google, existe o validador do schema.org (em inglês).

Como aparece no meu trabalho

No kahue.net, cada texto do blog sai com um bloco BlogPosting montado a partir do próprio frontmatter. As datas levam hora e o fuso de Brasília, como no trecho deste texto:

"datePublished": "2026-10-20T19:00:00-03:00",
"dateModified": "2026-10-20T19:00:00-03:00"

Quando o texto não tem data de revisão, o dateModified repete a de publicação. Deixei isso registrado no próprio código: repetir a publicação é honesto, e data de modificação inventada não é. A mesma página leva um BreadcrumbList com o caminho de início, blog e texto, que é o que a pessoa vê no topo.

Na Vexor, produto meu de assistente de IA no WhatsApp, o site declara a oferta e o preço no dado estruturado. Os valores são os da tabela visível: R$ 1.500 de montagem no plano mensal e mensalidade de R$ 400, R$ 650 ou R$ 1.200. Esse é o ponto da regra: um preço que existisse só no código seria justamente a informação invisível que o Google proíbe.

Nenhum desses sites tem medição publicada de efeito da marcação na busca. Os exemplos mostram como apliquei as regras, e não um resultado.

Onde a documentação parece se contradizer

O Google manda seguir a documentação dele, e não a do schema.org, para saber como a Pesquisa Google se comporta (Central da Pesquisa Google). O schema.org tem muitos tipos e propriedades que o Google não usa, mas que outros buscadores e ferramentas podem usar. Daí uma divisão prática: quem quer o resultado aprimorado segue o Google. Quem quer descrever bem a página para qualquer leitor de máquina pode ir além, desde que tudo continue visível.

A divergência maior é sobre o clique. Os casos do Google mostram mais cliques nas páginas marcadas. O NN/g lembra o outro lado: quando a resposta já aparece na página de resultados, a pessoa resolve a dúvida ali e não clica em nada (Kate Moran e Cami Goray, NN/g (em inglês)). Para quem busca, isso é bom. Para o site que escreveu a informação, nem tanto. Moran e Goray observam isso sobretudo em dúvida simples, como endereço, telefone ou definição (NN/g (em inglês)). Quando a decisão pede abrir a página, como comparar planos ou ler o texto inteiro, o clique continua sendo o caminho.

O erro comum: marcar o que a página não mostra

O erro mais caro é usar o dado estruturado como vitrine paralela. Nota de avaliação que não aparece no texto, preço promocional que só existe no código, autor que a página não cita. O teste automático aprova, porque a sintaxe está certa. O que o Google pede é outra coisa: a marcação precisa ser um retrato fiel da página, e avaliação falsa pode virar ação manual (diretrizes gerais). A conferência que resolve é simples: para cada propriedade do bloco, aponte onde ela está na tela.