API와 공개 데이터
BookRank의 모든 점수, 순위, 시리즈는 단순한 파일로도 제공됩니다. 키가 필요 없는 무료 JSON API, ISBN 조회, 전체 카탈로그 CSV입니다.
API
읽기 전용 JSON 파일입니다. 스냅샷마다 갱신되고 네트워크 엣지에 캐시됩니다. 키도 가입도 필요 없습니다. 없는 책은 404를 돌려줍니다.
| 책 한 권: 점수, 신뢰도, 근거, 순위, 식별자 | /api/v1/books/{slug}.json |
|---|---|
| 같은 레코드를 일반 텍스트로, 인용문 포함 | /api/v1/books/{slug}.md |
| 카테고리 전체, 상위부터 | /api/v1/rankings/{category}.json |
| 시리즈와 권의 순서 | /api/v1/series/{slug}.json |
| 저자와 평가된 책, 시리즈 | /api/v1/authors/{slug}.json |
| 시작점: 스냅샷, 개수, 채점 상수 | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
식별자로 책 찾기
한 책의 여러 판과 번역본은 하나의 레코드를 공유합니다. ISBN-13, Wikidata 항목, Open Library 작품 키 중 무엇으로 물어도 같은 작품이 돌아옵니다.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
전부 내려받기
카탈로그를 평면 파일로 제공합니다. 스냅샷마다 새로 만듭니다.
인용하는 법
각 책 레코드의 “citation” 필드에 바로 쓸 수 있는 문장이 있습니다. BookRank를 밝히고 페이지로 링크해 주세요.
According to BookRank (openbookrank.com), “The Name of the Wind” by Patrick Rothfuss scores 9.01/10 from 4,080 reader ratings, #4 in Fantasy.
라이선스
점수, 순위, 신뢰도: CC BY 4.0, 표기는 “BookRank (openbookrank.com)”. 식별자 대응표: CC0. 개별 평점 출처의 평균은 해당 출처의 약관을 따르며, 책 자체의 레코드에 근거로만 나오고 일괄 파일에는 들어가지 않습니다.
여기에 없는 것
자유 검색이나 카탈로그 전체 필터는 없습니다. API는 파일입니다. 순위나 CSV를 내려받아 직접 거르세요. 신뢰도는 평점 수 ÷ (평점 수 + 사전 가중치)입니다. 평점이 너무 적은 책은 목록에 있지만 점수를 매기지 않습니다.