JSON-LD(JSON for Linked Data)는 웹페이지의 정보를 schema.org 같은 어휘로 표현한 링크드 데이터를 JSON 문법으로 적는 W3C 표준 형식이며, 구글이 권장하는 구조화 데이터 마크업 방식이다.
W3C 규격은 JSON-LD를 “링크드 데이터를 직렬화하기 위한 JSON 기반 형식”으로 정의하고, 이미 JSON을 쓰는 시스템에 쉽게 얹히도록 설계했다고 밝힌다 (W3C, JSON-LD 1.1). 1.0은 2014년 1월 16일, 1.1은 2020년 7월 16일에 W3C 권고안이 됐다 (W3C, JSON-LD 1.0 권고안, W3C, JSON-LD 1.1 권고안 발표).
SEO에서는 페이지의 <script type="application/ld+json"> 태그 안에 넣어 검색엔진에 “이 페이지는 기사이고, 저자는 누구이고, 언제 발행됐다”를 알려주는 용도로 쓴다. 이 문서는 구조화 데이터 전반이 아니라 JSON-LD 형식 자체를 다룬다.
일반 JSON은 키의 의미를 정하지 않고, JSON-LD는 @context로 각 키를 웹상의 정의에 연결한다. 그래서 다른 시스템이 같은 데이터를 같은 뜻으로 읽을 수 있다.
위키백과는 JSON-LD를 “JSON을 써서 링크드 데이터를 인코딩하고 기존 JSON과 비슷하게 직렬화하는 방법”으로 설명하고, 컨텍스트가 JSON 속성을 온톨로지 개념에 대응시킨다고 적는다 (Wikipedia, JSON-LD). 규격은 RDF를 몰라도 JSON으로 그대로 쓸 수 있고, 필요하면 SPARQL 같은 링크드 데이터 기술과 함께 RDF로도 쓸 수 있다고 설명한다 (W3C, JSON-LD 1.1, 위 인용).
자주 쓰는 예약어는 @로 시작한다. JSON-LD 1.1 규격이 정의한 키워드 22개 중 SEO 마크업에 실제로 쓰이는 것은 아래 다섯 정도다 (W3C, JSON-LD 1.1, 위 인용).
| 키워드 | 역할 | 예 |
|---|---|---|
@context | 키의 뜻을 정의하는 어휘의 위치 | "https://schema.org" |
@type | 이 객체가 무엇인지 | "Article", "Product" |
@id | 객체의 고유 식별자(IRI) | "https://example.com/#organization" |
@graph | 여러 객체를 한 블록에 담는 배열 | WebSite, WebPage, Person을 한 번에 |
@value, @language | 값과 언어 표시 | {"@value": "제목", "@language": "ko"} |
@id는 같은 대상을 여러 페이지에서 가리킬 때 쓴다. 다만 크롤러는 같은 @id를 가진 노드의 속성을 여러 페이지에 걸쳐 합칠 수 있지만, 한 페이지만 읽는 스크레이퍼나 LLM은 합치지 않는다 (Hawksley, JSON-LD explained for personal websites).
AI 인용을 노린다면 페이지마다 필요한 속성을 다 적어야 한다.
같은 schema.org 어휘를 쓰는 세 형식 중 JSON-LD만 본문 HTML과 분리된 <script> 블록에 들어간다. 나머지 둘은 HTML 태그 속성으로 본문에 섞인다.
| 항목 | JSON-LD | Microdata | RDFa |
|---|---|---|---|
| 넣는 위치 | <head> 또는 <body>의 <script> 태그 | HTML 태그의 itemscope, itemprop 속성 | HTML 태그의 typeof, property 속성 |
| 본문과 분리 | 분리됨. 화면에 표시되지 않음 | 본문 태그에 결합 | 본문 태그에 결합 |
| 중첩 표현 | 쉬움 (JSON 객체 중첩) | 태그 구조를 따라야 함 | 태그 구조를 따라야 함 |
| 자바스크립트 동적 삽입 | 구글이 읽음 | 어려움 | 어려움 |
| 구글 | 권장 | 지원 | 지원 |
| 네이버 | 권장 | 권장 | 지원 |
구글은 “웹사이트 소유자가 규모에 맞게 구현하고 유지보수하기에 가장 쉬운 솔루션”이라는 이유로 JSON-LD를 권장하고, 마크업이 유효하면 세 형식을 똑같이 처리한다고 밝힌다 (Google 검색 센터, 구조화된 데이터 마크업 소개). 네이버 서치어드바이저는 “널리 사용하는 Microdata 형식이나 JSON-LD 형식”을 권장한다 (네이버 서치어드바이저, 구조화된 데이터 소개).
schema.org 자체는 처음에 Microdata에 집중했다가 여러 어휘를 섞거나 관계 방향을 뒤집는 작업이 Microdata로는 어려워 RDFa와 JSON-LD를 함께 지원하게 됐다고 설명한다 (schema.org, FAQ).
검색결과에 리치 결과를 붙이고, 페이지의 엔티티를 지식 그래프에 연결하는 데 쓴다. 구글 검색 갤러리가 구조화 데이터로 지원하는 기능은 기사, 탐색경로, 이벤트, 채용 정보, 제품, 레시피, 리뷰 스니펫, 동영상 등 27종이다 (Google 검색 센터, 구조화된 데이터 마크업 갤러리).
다만 마크업이 결과를 보장하지는 않는다. 구글은 일반 가이드라인에서 “구조화된 데이터가 검색결과에 표시된다고 보장하지 않습니다”라고 명시하고, 독자에게 보이지 않는 콘텐츠를 마크업하거나 사용자를 속이는 마크업을 금지한다 (Google 검색 센터, 구조화된 데이터 일반 가이드라인).
리치 결과가 무엇인지는 리치 스니펫 문서에 정리했다.
AI 검색에는 별도 요건이 없다. 구글은 AI 개요와 AI 모드에 표시되기 위해 “별도로 추가해야 하는 구조화된 schema.org 데이터도 없다”고 밝히면서, 구조화 데이터가 페이지에 실제로 표시되는 텍스트와 일치하는지는 확인하라고 안내한다 (Google 검색 센터, Google 검색의 AI 기능).
검색엔진 밖에서도 쓰인다. 위키백과는 schema.org와 구글 지식 그래프 외에 ActivityPub(연합 소셜 네트워크), 생물의학 정보, IoT 기기 설명에 JSON-LD가 쓰인다고 적는다 (Wikipedia, JSON-LD, 위 인용).
@context와 @type을 정하고 그 타입에 필요한 속성을 채운 뒤 <script> 태그로 페이지에 넣는다. 구글이 기사에 권장하는 속성은 headline, image, datePublished, dateModified, author 다섯이다 (Google 검색 센터, 기사 구조화된 데이터).
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "NewsArticle",
"headline": "Title of a News Article",
"image": ["https://example.com/photos/16x9/photo.jpg"],
"datePublished": "2024-01-05T08:00:00+08:00",
"dateModified": "2024-02-05T09:20:00+08:00",
"author": [{
"@type": "Person",
"name": "Jane Doe",
"url": "https://example.com/profile/janedoe123"
}]
}
</script>작성 절차는 다음과 같다.
<head>나 <body> 안 <script type="application/ld+json"> 블록에 넣는다. 구글은 어느 쪽이든 읽는다 (Google, 구조화된 데이터 마크업 소개, 위 인용).@graph 배열에 담거나 <script> 블록을 여러 개 둔다.예외가 하나 있다. 제품 마크업을 동적으로 생성하면 “쇼핑 크롤링의 빈도가 줄고 신뢰도가 떨어질 수 있다”고 구글이 경고하므로, 가격과 재고처럼 자주 바뀌는 값은 서버에서 렌더링하는 편이 낫다 (Google, JavaScript로 구조화된 데이터 생성, 위 인용).
W3Techs 조사 기준 2026년 9월 전체 웹사이트의 55.7%가 JSON-LD를 쓴다. Microdata는 21.3%, RDFa는 36.8%이고, 오픈 그래프는 72.2%로 가장 많다 (W3Techs, Usage statistics of structured data formats).
Common Crawl 2024년 10월 데이터를 분석한 Web Data Commons 통계도 같은 방향이다. 구조화 데이터를 가진 도메인 16,525,070개 중 JSON-LD가 11,562,359개, Microdata가 7,599,792개, RDFa가 474,635개였다 (Web Data Commons, Structured Data Extraction October 2024).
한 도메인이 여러 형식을 함께 쓸 수 있어 합은 전체를 넘는다.
어휘 쪽 수치도 있다. schema.org는 2024년 기준 4,500만 개 이상 웹 도메인이 4,500억 개 이상의 schema.org 객체를 마크업한다고 밝힌다 (schema.org).
문법 검사와 검색엔진 지원 검사를 나눠서 한다. 세 도구가 각각 다른 것을 본다.
| 도구 | 보는 것 | URL |
|---|---|---|
| 리치 결과 테스트 | 구글이 지원하는 리치 결과 자격이 있는지, 필수 속성 누락 | search.google.com/test/rich-results |
| 스키마 마크업 검사 도구 | schema.org 어휘 기준 문법 오류 (리치 결과 자격은 안 봄) | validator.schema.org |
| JSON-LD Playground | JSON-LD 규격 기준 확장, 압축, RDF 변환 결과 | json-ld.org/playground |
구글은 리치 결과 테스트로 유효성을 검사하고 검색 기능을 미리 볼 수 있다고 안내하며, 발행 후에는 서치콘솔의 URL 검사와 실적 보고서로 확인하라고 권한다 (Google, 구조화된 데이터 마크업 소개, 위 인용). JSON-LD Playground는 json-ld.org가 학습과 디버깅용으로 제공하는 웹 기반 뷰어다 (JSON-LD.org).
구글 키워드 플래너 기준 “json ld”는 월 평균 480회이고 2026년 1월부터 7월까지 590회를 유지하다 8월 480회였다 (서치폴라리스, 구글 키워드 플래너 2026-09-29 조회). “스키마 마크업”은 210회, “구조화 데이터”는 20회다.
네이버 검색광고 기준 PC 10회, 모바일 10회 미만이고 자동완성이 없다. 구글 자동완성은 “json-ld 란”, “json-ld 스키마”, “json-ld vs json”, “json-ld playground”, “json-ld seo”, “json-ld rdf”, “json-ld product”, “json-ld checker” 순이다.
구글 1페이지 10건 중 SEO 관점 문서가 7건, 규격 자체를 다루는 문서가 3건(json-ld.org, 위키백과 2건)이었다. 그래서 이 문서는 SEO 용도를 앞에 두되 JSON과의 차이와 규격 키워드를 별도 섹션으로 넣었다.
웹페이지의 내용을 검색엔진이 이해하는 형식으로 적는 JSON 기반 W3C 표준이다. 페이지 HTML 안에 <script type="application/ld+json"> 블록으로 들어간다.
문법은 같고 @context, @type, @id 같은 예약어가 추가된 것이 차이다. 예약어 덕분에 키가 웹상의 정의에 연결되어 다른 시스템도 같은 뜻으로 읽을 수 있다.
구글은 리치 결과 표시조차 보장하지 않는다고 밝힌다. 순위 요소가 아니라 검색결과의 표시 방식과 엔티티 이해를 돕는 수단으로 보는 것이 맞다.
schema.org 타입 목록에서 고르되, 검색결과에 반영되는 것은 구글 검색 갤러리 27종처럼 검색엔진이 문서로 지원하는 타입뿐이다.
json-ld.org가 제공하는 웹 기반 JSON-LD 뷰어이자 디버거다. 마크업을 붙여 넣으면 확장, 압축, RDF 변환 결과를 보여 준다.
서치폴라리스가 AI 검색 가시성을 진단하고 GEO 실행까지 대행합니다.