API e dados abertos
Cada nota, cada posição e cada série do BookRank também é um arquivo simples: uma API JSON gratuita e sem chave, busca por ISBN e o catálogo inteiro em CSV.
API
Arquivos JSON somente leitura, renovados a cada retrato dos dados e guardados em cache na borda da rede. Sem chave e sem cadastro. Um livro que não temos devolve 404.
| Um livro: nota, confiança, evidências, posições, identificadores | /api/v1/books/{slug}.json |
|---|---|
| O mesmo registro em texto simples com uma citação pronta | /api/v1/books/{slug}.md |
| Uma categoria inteira, do melhor para baixo | /api/v1/rankings/{category}.json |
| Uma série com os volumes em ordem | /api/v1/series/{slug}.json |
| Um autor com livros avaliados e séries | /api/v1/authors/{slug}.json |
| Ponto de entrada: retrato, contagens, constantes da nota | /api/v1/index.json |
| OpenAPI 3.1 | /api/v1/openapi.json |
Encontre um livro por um identificador
Edições e traduções de um livro dividem um só registro. Pergunte com qualquer ISBN-13, um item do Wikidata ou uma chave de obra da Open Library e receba a mesma obra.
| ISBN-13 | /api/v1/isbn/{isbn13}.json |
|---|---|
| Wikidata | /api/v1/wikidata/{qid}.json |
| Open Library | /api/v1/openlibrary/{work}.json |
Baixe tudo
O catálogo em arquivos planos, refeito a cada retrato dos dados.
Como citar
Cada registro de livro traz uma frase pronta no campo “citation”. Cite o BookRank e coloque o link da página.
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.
Licença
Notas, posições e confiança: CC BY 4.0, com o crédito “BookRank (openbookrank.com)”. A tabela de identificadores: CC0. As médias de cada fonte de avaliações seguem os termos dessas fontes e aparecem só como evidência no registro de um livro, nunca nos arquivos em massa.
O que não há aqui
Não há busca por texto livre nem filtros sobre o catálogo: a API são arquivos. Baixe um ranking ou o CSV e filtre você mesmo. Confiança é avaliações ÷ (avaliações + peso prévio); um livro com avaliações de menos aparece, mas sem nota.