# Goodreads Scraper
## Overview
| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v1/website/rendering` |
| **Base URL** | `https://api.browsersolver.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.browsersolver.com/library/website-rendering-goodreads-scraper |
## Access
This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.browsersolver.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.
## Description
Snapshot public Goodreads pages as post-render HTML for site monitoring, data enrichment, and archival jobs.
## Authentication
- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.browsersolver.com/register
## Example Request
```bash
curl --location --request GET 'https://api.browsersolver.com/v1/website/rendering' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY'
```
## Example Response
### Goodreads ads HTML
```json
Ads | GoodreadsSponsoredHarbor Audio
example.com/earbuds
Goodreads HTML fixtures for BrowserSolver rendering examples.
```
## Documentation
## Goodreads via BrowserSolver
Point **Goodreads Scraper** at a public Goodreads URL to snapshot the DOM once dynamic modules are visible.
| | |
|---|---|
| Endpoint | `/v1/website/rendering` |
| Credits | 2 / successful call |
| Auth | API key |
### Try it
```
GET https://api.browsersolver.com/v1/website/rendering?query=https://www.goodreads.com/search?q=design+of+everyday+things
```
### Response
HTML post JavaScript.
### Common workflows
- Archive sponsored placements
- Sample ad libraries
- Study competitor creatives
#
## Workflows
- Capture sponsored creative blocks
- Track advertiser landing URLs
- Archive ads transparency modules
## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Absolute Goodreads URL |
| `wait_in_seconds` | number | no | Extra pause after load (0-30) |
| `wait_for` | string | no | CSS/XPath selector that must appear |
| `block_ads` | boolean | no | Drop ad traffic during render |
| `timeout` | number | no | Max render seconds (default 30) |
## Notes
- Prefer [Website Crawler](/v1/website/crawler) if markup arrives without JS.
- Use [Website WebUnlocker](/v1/website/webunlocker) only on approved, heavily protected hosts.