프로그램끼리 데이터를 주고받을 때 가장 많이 쓰는 텍스트 형식이다. 사람도 어느 정도 읽을 수 있고, 거의 모든 프로그래밍 언어가 기본 지원한다.

왜 JSON을 그렇게 많이 쓰나요?

구조가 단순하고, 텍스트라서 가볍고, 사람도 읽을 수 있어서다. XML 같은 옛 형식보다 훨씬 간결해 90년대 이후 사실상 표준이 됐다.

JSON과 JavaScript는 같은 건가요?

다르다. JSON은 JavaScript 객체 표기법(Object Notation)에서 영감을 받았지만, 이제는 언어와 무관하게 모든 프로그램이 쓴다. Python·Go·Rust 어디든 기본 지원.

JSON과 CSV는 뭐가 다른가요?

CSV는 표 한 장처럼 단순한 행·열 데이터에 어울리고, JSON은 중첩된 구조(배열 안 객체, 객체 안 배열)를 자연스럽게 표현한다. AI API 응답은 거의 항상 JSON이다.

AI API 응답도 JSON이에요?

그렇다. OpenAI·Anthropic·Google API 모두 JSON 형식으로 응답한다. 사용자 코드는 그 JSON에서 답변 텍스트를 꺼내 화면에 보여주는 구조다.

JSON 파일 확장자는 뭔가요?

.json이 표준이다. 텍스트 에디터로 바로 열린다. VS Code·Cursor 같은 IDE는 자동으로 색상·들여쓰기를 적용해 보기 편하게 만든다.

JSON에서 주석 쓸 수 있나요?

표준 JSON은 주석을 허용하지 않는다. 대안으로 JSONC(주석 허용 변형)나 YAML을 쓰기도 한다. AI 도구의 설정 파일은 JSONC인 경우도 많다.

JSON 형식이 깨졌을 때 어떻게 찾나요?

괄호·따옴표·콤마 위치를 본다. jsonlint.com 같은 온라인 검증기, IDE의 빨간 줄 표시, python -m json.tool 같은 명령으로 빠르게 찾을 수 있다.

JSON Schema가 뭔가요?

JSON 데이터의 구조를 미리 정의해 검증하는 표준이다. AI Function Calling에서 '이 함수는 이런 인자를 받는다'를 명시할 때 자주 쓴다.

AI 글 자동 발행에도 JSON을 쓰나요?

그렇다. ai-tong-tong 같은 자동화 사이트의 주제 큐(topic_queue.json), 발행 큐(publish-queue.json) 모두 JSON이다. 사람이 직접 편집하기 쉽고 코드가 처리하기도 편하다.

JSON과 YAML은 뭐가 다른가요?

둘 다 데이터를 표현하는 텍스트 형식이다. JSON은 괄호·따옴표가 많고 기계 친화적, YAML은 들여쓰기 기반이라 사람이 읽기 더 편하다. GitHub Actions 워크플로는 YAML을 주로 쓴다.

JSON을 처음 보는 사람은 어디서부터 배우면 되나요?

AI API 응답을 직접 본 뒤 한 항목씩 따라가는 방식이 빠르다. 'response.choices[0].message.content' 같은 표현이 결국 JSON 안 한 칸을 가리키는 것임을 이해하면 절반은 끝난다.

#051 · 66편 중

JSON이 뭐야? 데이터 주고받는 표준 형식 5분 정리

2026년 5월 9일 · 수정 2026. 5. 9. AI 통통

AI API를 처음 호출해 보면 응답이 이런 모양으로 온다.

{
  "id": "msg_01ab...",
  "type": "message",
  "content": [{"type": "text", "text": "안녕하세요"}],
  "usage": {"input_tokens": 10, "output_tokens": 5}
}

이게 JSON이다. AI 시대에 들어 거의 모든 데이터 통신이 이 한 형식 위에서 일어난다.

JSON 개념을 설명하는 AI 통통 입문 가이드 이미지

JSON 한 줄 정의

**JSON(JavaScript Object Notation)**은 프로그램끼리 데이터를 주고받을 때 가장 많이 쓰는 텍스트 형식이다.

이름에 JavaScript가 들어가지만 이제는 모든 언어·모든 시스템에서 표준처럼 쓰인다. AI API, 자동화 도구, 설정 파일, 모바일 앱 통신까지 거의 모든 곳에 들어간다.

핵심 매력은 단순함이다. 사람도 읽을 수 있고, 기계가 파싱하기도 쉽다. 그 균형 때문에 90년대 후반부터 자리를 잡아 지금까지 자리를 지키고 있다.

중학생도 이해하는 비유

JSON을 이해하는 가장 쉬운 비유는 편지에 적힌 표 양식이다.

상자(객체)와 목록(배열) 두 가지로 거의 모든 정보를 표현할 수 있다.

{
  "이름": "토큰",
  "나이": 30,
  "직업": ["블로그 운영자", "AI 도구 사용자"],
  "도구": {
    "에디터": "Cursor",
    "AI": ["Claude", "ChatGPT"]
  }
}

이 작은 글에 한 사람의 정보가 다 담겼다. 상자 안에 또 상자, 목록 안에 또 상자를 넣을 수 있어서 복잡한 정보도 자연스럽게 표현된다.

또 한 가지 중요한 점. JSON은 텍스트다. 메모장이든 카톡이든 어디로든 그대로 복사·붙여넣기 가능하다. 이 단순함이 JSON의 가장 큰 강점이다.

JSON의 기본 규칙 6가지

처음 JSON을 본다면 이 6가지만 알면 거의 모든 JSON을 읽을 수 있다.

객체 { "키": 값 } — 중괄호로 감싸고 키:값 쌍
배열 [ 값, 값 ] — 대괄호로 감싸고 콤마로 구분
문자열 "hello" — 항상 큰따옴표 (작은따옴표 X)
숫자 42, 3.14 — 따옴표 없이
불리언 true, false — 소문자
null null — 값이 없음을 의미

이 외에 콤마·콜론·따옴표 위치 정도만 신경 쓰면 된다. 형식 위반은 IDE·온라인 검증기가 즉시 잡아준다.

실제 사용 예시

예시 1: AI API 응답 ChatGPT·Claude API에 질문을 보내면 답변이 JSON으로 돌아온다. 사용자 코드는 그 JSON에서 답변 텍스트만 꺼내 화면에 보여준다.

예시 2: 자동화 워크플로 설정 ai-tong-tong의 publish-queue.json은 다음과 같이 슬롯별 글을 관리한다.

{
  "morning": ["cache", "chatgpt-tasks-..."],
  "lunch": ["cloud"],
  "evening": ["domain", "claude-code-vs-cursor-..."]
}

cron이 매일 시점에 이 JSON을 읽어 어떤 글을 발행할지 결정한다.

예시 3: package.json Node.js 프로젝트의 의존성 정보가 담긴 핵심 파일도 JSON이다.

예시 4: AI Function Calling LLM이 도구를 호출할 때 인자를 JSON으로 표현한다. JSON Schema로 함수 입력 형식을 미리 정의해 둔다.

AI API 응답 한 번 직접 읽어보기

Anthropic API 응답을 일부 단순화해 보자.

{
  "id": "msg_01XYZ",
  "model": "claude-sonnet-...",
  "content": [
    {"type": "text", "text": "안녕하세요, 무엇을 도와드릴까요?"}
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 8
  }
}

여기서 사용자에게 보여줄 답변은 content[0].text 한 칸이다. 토큰 사용량은 usage.input_tokens, usage.output_tokens. 이 정도만 꺼낼 줄 알면 첫 API 호출 코드는 끝난다.

비슷한 용어와 차이

용어	뜻	JSON과의 차이
YAML	들여쓰기 기반 데이터 형식	사람이 읽기 더 편함, 기계 파싱은 좀 더 까다로움
XML	태그 기반 데이터 형식	JSON 등장 전 표준, 더 무거움
CSV	표 한 장 형식	중첩 구조 표현 어려움
JSON Schema	JSON의 구조 정의	JSON을 검증하는 별도 표준
JSONC	주석 허용 JSON	표준 JSON은 주석 X

따라서 “JSON = 무거운 형식”이 아니다. JSON은 가볍고 단순한 텍스트이고, 더 간결한 형식이 필요하면 YAML이나 CSV로 옮겨가기도 한다.

언제 JSON을 마주치나

AI API 응답·요청: 거의 항상 JSON
package.json·tsconfig.json: 개발 프로젝트 설정 파일
자동화 큐 관리: ai-tong-tong의 publish-queue 같은 파일
Postman·Insomnia 같은 API 테스트 도구: 모든 응답이 JSON으로 표시
AI Function Calling: LLM이 함수 호출 시 인자를 JSON으로 표현