공지사항

안녕하세요. 예스24입니다.

그동안 많은 이용자분들께서 보내주신 의견을 반영하여, 2026년 10월 1일부터 책등 및 뒷표지 이미지 URL을 추가 제공합니다.
기존에 제공하던 앞표지(cover)와 함께 활용하면 도서 이미지를 보다 다양하게 제공할 수 있습니다.

적용 일시

• 2026년 10월 1일 목요일 오전 10시경 (KST)

추가 항목

• sideCover : 책등 이미지 URL
• backCover : 뒷표지 이미지 URL
• detail=N(기본), detail=Y 모두 포함되며, 기존 cover 항목 바로 뒤에 위치합니다.

대상 API

• 상품 : 상품 검색, 상품 상세
• 베스트셀러 : 실시간, 종합, 특가, 스테디셀러, 일별, 월별
• 신상품 : 신상품, 주목할 신상품

이용방법

• 응답의 URL을 이미지 주소로 그대로 사용하시면 됩니다. 별도 호출이나 추가 인증은 필요하지 않습니다.
• 기존 응답 항목은 변경되지 않으므로 연동 중인 서비스는 수정 없이 그대로 이용하실 수 있습니다.
• 적용 이후 API 테스트 메뉴에서 실제 응답을 바로 확인하실 수 있습니다.

유의 사항

• 책등·뒷표지 이미지가 모든 상품에 등록되어 있는 것은 아닙니다. 이미지가 없는 상품도 URL은 반환되며, 해당 URL에서는 대체 이미지가 표시됩니다.
• 이미지 등록 여부를 응답값만으로 구분할 수 없으므로, 책등 이미지가 중심이 되는 화면에서는 일부 상품에 대체 이미지가 표시될 수 있는 점을 고려해 주세요.
• 책등·뒷표지 이미지 URL은 Excel 다운로드(/export) 결과에는 포함되지 않습니다.
• 각 응답 필드에 대한 자세한 내용은 API 문서에서 확인하실 수 있습니다.

앞으로도 이용자 여러분의 의견에 귀 기울여 더 나은 서비스를 제공하겠습니다.

감사합니다.

안녕하세요. 예스24 Open API를 이용해 주시는 여러분께 감사드립니다.

서비스 운영 정책 정비에 따라, 주요 문의 사항과 향후 운영 방향을 아래와 같이 안내드리오니 이용에 참고하여 주시기 바랍니다.

요금 정책

Basic 플랜은 향후에도 무료로 제공될 예정입니다.
상위 플랜(Partner, Enterprise)에 대해서는 유료화 계획이 있으나 세부 내용 및 일정은 아직 확정되지 않았습니다.
요금 정책이 변경되는 경우 사전 공지드릴 예정입니다.
서비스 운영 정책과 관련한 추가 사항은 확정되는 대로 본 공지사항을 통해 안내드리겠습니다.

이용 시 준수 사항

Open API 이용 시 아래 사항을 준수해 주시기 바랍니다.

• 출처 표기 : 도서 정보가 노출되는 화면에 예스24 출처를 표기해 주시기 바랍니다.
• 링크 연결 : 도서 상세 정보 또는 구매 관련 영역에서 해당 도서의 예스24 상품 상세페이지로 연결해 주시기 바랍니다.
• 데이터 이용 범위 : API를 통해 제공받은 데이터는 서비스 제공에 필요한 범위 내에서 캐싱하여 사용하실 수 있습니다.
  다만, 전체 도서 정보를 수집하여 자체 데이터베이스로 축적하거나 제3자에게 재배포하는 것은 허용되지 않습니다.
• API Key 공동 사용 금지 : 발급받으신 API Key를 다른 서비스나 사업자와 공동으로 사용하실 수 없습니다.

Partner 등급 상향 신청 안내

Basic 플랜의 호출 한도를 초과하는 이용이 필요하신 경우, 1:1 문의를 통해 Partner 등급 상향을 신청하실 수 있습니다.
신청 시 아래 정보를 함께 기재해 주시기 바랍니다.

• 서비스 정보 (서비스명, URL 또는 앱스토어 링크)
• 예상 일일 호출량 및 피크 시간대 초당 호출량(RPS)
• 담당자 이메일

법인·기관 이용 안내

법인, 기관, 도서관 등 단체 명의로 API를 이용하시는 경우, 예스24 법인회원으로 가입하신 후 API Key를 발급받으시는 것을 권장드립니다.
법인회원 가입은 예스24 회원가입 페이지에서 하실 수 있습니다. (https://www.yes24.com/Member/Join/Accept.aspx)
담당자 개인 계정으로 발급받으신 경우 담당자 변경 시 서비스 이용에 영향이 있을 수 있습니다.
법인·기관 대상 계약 절차는 운영 정책 확정 후 별도로 안내드릴 예정이며, 그 전까지는 현재와 같이 이용하실 수 있습니다.

안내드린 내용 외에 궁금하신 사항이 있으시면 1:1 문의로 남겨 주시기 바랍니다.

감사합니다.

안녕하세요. 예스24입니다.

예스24 Open API 공개 후 한 달 동안, 많은 개발자와 파트너 여러분께서 다양한 서비스에 연동해 주셨습니다.

보내주신 관심과 성원에 감사드리며, 보다 여유로운 환경에서 활용하실 수 있도록 기본 제공 호출 한도를 대폭 상향합니다.
Basic 등급의 일일 호출량은 4배, 초당 호출량은 2배로 확대되며, Partner 등급의 일일 호출량도 2배로 늘어납니다.

변경 내용

• Basic — 일일 5,000회 → 20,000회 / 초당 5회 → 10회
• Partner — 일일 50,000회 → 100,000회 / 초당 20회 (변동 없음)
• Enterprise — 일일 500,000회 / 초당 50회 (변동 없음)

적용 시점

• 2026년 8월 13일부터 즉시 적용됩니다.
• 별도 신청이나 API Key 재발급은 필요하지 않습니다. 기존 API Key에 변경된 한도가 자동으로 적용됩니다.

참고 사항

• 호출량은 API Key가 아닌 계정 단위로 누적되며, 한국 표준시(KST) 기준 매일 00시에 초기화됩니다.
• 현재 적용된 호출 한도와 사용량은 이용 현황에서 확인하실 수 있습니다.
• 상향된 한도를 초과하는 이용이 필요한 경우 1:1 문의로 요청해 주시면 이용 목적과 규모를 확인하여 안내드리겠습니다.

앞으로도 예스24 Open API에 많은 관심과 이용 부탁드립니다.

감사합니다.

안녕하세요. 예스24입니다.

내부 도서DB 작업으로 인해 예스24 Open API 서비스가 아래와 같이 일시 중단됩니다.

작업 일정

• 2026년 8월 16일(일) 00:00 ~ 09:00 (약 9시간 소요 예정)
• 작업 완료 시점에 따라 서비스가 예정 시간보다 일찍 재개될 수 있으며, 재개 시 별도 안내 없이 자동으로 정상화됩니다.

작업 내용 및 영향

• 위 시간 동안 전체 Open API 이용이 불가하며, API 호출 시 오류가 발생할 수 있습니다.
• 연동 중이신 서비스가 있다면 사전에 예외 처리 또는 재시도 로직을 점검해 주시기 바랍니다.

보다 안정적인 서비스를 제공하기 위해 최선을 다하겠습니다.
감사합니다.

예스24의 도서·상품 데이터를 외부 서비스에서 활용할 수 있는 Public API를 제공합니다.

이번 공개 범위에서는 카테고리 목록, 베스트셀러, 스테디셀러, 신상품, 상품 검색, 상품 상세, 상품 목차, 작가 기본 정보 조회 기능을 제공합니다.

• 모든 API는 REST 방식의 GET 엔드포인트로 제공되며, 응답은 JSON 형식의 공통 구조로 반환됩니다.
• 목록형 API는 page, pageSize 기반 페이징을 지원합니다.
• 일부 상품 목록 API는 detail 파라미터로 간단 정보와 상세 정보를 선택할 수 있습니다.
• 카테고리 및 주요 상품 목록은 Excel 다운로드용 엔드포인트도 함께 제공합니다.
• 서비스 안정화 작업에 따라 일부 응답 필드나 제공 범위가 조정될 수 있습니다.

API Key 발급, 인증 헤더, 호출 제한, 오류 처리 등 자세한 이용 방법은 문서와 FAQ를 참고해 주세요.