상품 목차 조회

상품 번호 또는 ISBN13으로 도서 목차 정보를 조회합니다.

개요

상품 목차 조회 API는 상품 번호 또는 ISBN13으로 도서 목차 정보를 조회합니다.

Endpoint

GET https://apis.yes24.com/v1/goods/content

Query Parameters

파라미터	타입	필수	기본값	설명
`searchType`	string	필수	ISBN13	검색 유형(ISBN13 또는 ItemId)
`query`	string	필수	-	ISBN13 값 또는 상품 번호(ItemId)

Request Example

Shell

curl -X GET "https://apis.yes24.com/v1/goods/content?searchType=ISBN13&query=9788966260959" -H "X-Api-Key: yk_live_YOUR_API_KEY"

Response Example

JSON

{
  "success": true,
  "message": "성공",
  "errorCode": null,
  "data": {
    "meta": {
      "apiTitle": "상품 목차 조회",
      "apiLink": "https://apis.yes24.com/v1/goods/content?searchType=ISBN13&query=9788966260959",
      "logoUrl": "https://image.yes24.com/sysimage/renew/gnb/logoN4.svg",
      "pubDate": "2026-07-14T09:16:14+09:00",
      "query": "?searchType=ISBN13&query=9788966260959",
      "version": "v1"
    },
    "data": {
      "itemId": 12345678,
      "contents": "1장 깨끗한 코드\n2장 의미 있는 이름\n3장 함수\n..."
    }
  }
}

Response Fields

필드	타입	설명
`success`	boolean	요청 성공 여부
`message`	string	응답 메시지
`errorCode`	string \| null	오류 코드(성공 시 null)
`data.meta.apiTitle`	string	호출한 API 제목
`data.meta.apiLink`	string	요청 URL
`data.meta.logoUrl`	string	예스24 로고 URL
`data.meta.pubDate`	string	응답 일시(ISO 8601)
`data.meta.query`	string	요청 QueryString
`data.meta.version`	string	API 버전
`data.data.itemId`	integer	예스24 상품 번호
`data.data.contents`	string	상품 목차 내용(줄바꿈 포함)

오류 코드

HTTP	오류 코드	설명
401	`AUTH_001`	X-Api-Key 헤더가 없습니다.
401	`AUTH_002`	유효하지 않은 API Key입니다.
400	`PARAM_004`	유효하지 않은 query 입니다.
404	`GOODS_001`	상품 목차 정보가 없습니다.
404	`GOODS_002`	ISBN13에 해당하는 상품을 찾을 수 없습니다.