Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Goodreads Search

Pesquisa livros no Goodreads. pagination.next é o URL Goodreads da página seguinte.

Ativo2 créditos = 1 requisiçãoGET/v2/goodreads/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

Pesquisa livros. query é obrigatório, por exemplo dune. page é opcional e começa em 1. O id de Dune é 44767458. pagination.next é um URL Goodreads como https://www.goodreads.com/search?q=dune&page=2. A página 2 traz outros ids e page 2. Um texto como 1.7 million fica 1700000. A ficha do livro traz a contagem exata.

ParâmetrosLink to Parâmetros

Parâmetro Obrigatório Exemplo
query sim dune
page não 2

PaginaçãoLink to Paginação

page vem de Page N of M ou do URL. total_pages é M (100 em dune). total_results é null. per_page é o número de cartões, 20 numa página cheia. next é null só na última página.

Casos de usoLink to Casos de uso

  • Resolver Dune para o id 44767458.
  • Seguir pagination.next sem repetir ids da página 1.
  • Comparar a contagem abreviada do cartão com a da ficha do livro.

ErrosLink to Erros

400 consulta vazia ou página menor que 1, 401 sem chave, 404 não é uma pesquisa, 500 falha na leitura.

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos