Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de Goodreads Search

Busca libros en Goodreads. pagination.next es la URL de Goodreads de la página siguiente.

Activo2 créditos = 1 solicitudGET/v2/goodreads/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

ResumenLink to Resumen

Busca libros. query es obligatorio, por ejemplo dune. page es opcional y empieza en 1. El id de Dune es 44767458. pagination.next es una URL de Goodreads como https://www.goodreads.com/search?q=dune&page=2. La página 2 trae otros ids y page 2. Un texto como 1.7 million se guarda como 1700000. La ficha del libro trae el recuento exacto.

ParámetrosLink to Parámetros

Parámetro Obligatorio Ejemplo
query sí dune
page no 2

PaginaciónLink to Paginación

page sale de Page N of M o de la URL. total_pages es M (100 en dune). total_results es null. per_page es el número de fichas, 20 en una página llena. next es null solo en la última página.

Casos de usoLink to Casos de uso

  • Resolver Dune al id 44767458.
  • Seguir pagination.next sin repetir ids de la página 1.
  • Comparar el recuento abreviado de la ficha con el de la página del libro.

ErroresLink to Errores

400 consulta vacía o página menor que 1, 401 sin clave, 404 no es una búsqueda, 500 fallo de lectura.

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos