# Pangobooks

> Pangobooks is a marketplace for physical used books (no ebooks or audiobooks).
> Use the public research API below instead of scraping HTML — especially for pricing and search.

Website: https://pangobooks.com
Human docs / try-it: https://pangobooks.com/public-api
OpenAPI: https://pangobooks.com/openapi.json
Sitemap: https://pangobooks.com/sitemaps/sitemap_index.xml

## Preferred research flow

1. Search titles (or books)
2. Fetch pricing by ISBN and/or a specific listing by book id
3. Link humans to the canonical HTML URLs returned in `urls`

## Public research API

No API key required. CORS open (`Access-Control-Allow-Origin: *`).
Response shape: `{ "success": true, "data": { ... } }`

### Rate limits

| Tier | Limit | Auth |
|------|-------|------|
| Free | 10 requests / minute (per IP) | None |
| Registered | 30 requests / minute (per account) | `Authorization: Bearer <auth_token>` from a free Pangobooks account |

Over limit → HTTP `429` + `Retry-After`, with JSON like:

```json
{
  "error": "Too many requests",
  "message": "Free public API limit is 10 requests per minute. Create a free Pangobooks account and send Authorization: Bearer <auth_token> for 30 requests per minute. Docs: https://pangobooks.com/public-api",
  "tier": "free",
  "limit_per_minute": 10,
  "retry_after": 60,
  "upgrade": {
    "limit_per_minute": 30,
    "how": "Send Authorization: Bearer <auth_token> from a registered Pangobooks account",
    "docs": "https://pangobooks.com/public-api"
  }
}
```

### Search (find a title or listing)
- `GET https://pangobooks.com/api/public/search?q={query}&type=titles&limit=5`
- `type`: `titles` (default, preferred) or `books`
- `limit`: 1–10 (default 5). No deep pagination — page 1 only.

### Market pricing (ISBN comps / sold prices)
- `GET https://pangobooks.com/api/public/pricing?isbn={isbn}`
- Prefer this over crawling `/pricing` HTML.

### Listing detail (buy a specific copy)
- `GET https://pangobooks.com/api/public/books/{bookId}`
- HTML equivalent: https://pangobooks.com/books/{bookId}

## Examples

```
GET https://pangobooks.com/api/public/search?q=project+hail+mary&type=titles&limit=5
GET https://pangobooks.com/api/public/pricing?isbn=9780593135204
GET https://pangobooks.com/api/public/books/{bookId}

# Registered tier (30/min)
GET https://pangobooks.com/api/public/pricing?isbn=9780593135204
Authorization: Bearer <auth_token>
```

## HTML surfaces (optional)

- Title pages: https://pangobooks.com/titles/{slug}
- Pricing hub: https://pangobooks.com/pricing
- Canonical pricing: https://pangobooks.com/pricing/author/{authorId}/{titleSlug}/{isbn}
- Listings: https://pangobooks.com/books/{bookId}

## Please do not

- Hammer HTML `/search` or paginate search results for research
- Scrape `/pricing` HTML when the ISBN pricing API is available
- Bypass rate limits or ignore `Retry-After`
- Request unbounded result sets (use `limit` ≤ 10)

## Contact

https://pangobooks.com/help