# Indiebound — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Discover independent bookstores near you, search for books across curated bestseller and Indie Next lists, and explore book recommendations from IndieBound's community. Access detailed book information, find locally-owned bookstores, and browse the latest indie bookstore news and events.

**Category:** E-commerce | **Website:** [indiebound.org/](https://indiebound.org/) | **Docs:** [parse.bot/marketplace/34104d08-ee4f-4c18-b5ef-f095ad2dcc2d/indiebound-org-api](https://parse.bot/marketplace/34104d08-ee4f-4c18-b5ef-f095ad2dcc2d/indiebound-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### find_indie_bookstores

Search for independent bookstores near a location by submitting a form to IndieBound's store finder. Returns store names, cities, states, distances, coordinates, and info window HTML with addresses and website links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | ZIP code, city name, or address to search near (e.g. '10001', 'New York'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/find_indie_bookstores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>"}'
```

### get_blog_posts

Retrieve IndieBound blog posts with titles, links, and image URLs. Returns paginated results starting at page 0.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting at 0. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/get_blog_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_book_details

Get price and availability details for a specific book by ISBN. Redirects to Bookshop.org and extracts title, author, pricing, and availability information from the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `isbn` | string | Yes | ISBN-13 of the book (e.g. '9780441013593'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/get_book_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"isbn":"<string>"}'
```

### get_bookstore_day_info

Retrieve information about Independent Bookstore Day, including the page title and full text content about the annual event celebrating independent bookstores nationwide.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/get_bookstore_day_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_indie_bestsellers

Retrieve the current weekly Indie Bestseller lists organized by category (Hardcover Fiction, Hardcover Nonfiction, Trade Paperback Fiction). Each category contains ranked books with titles, authors, image URLs, and buy-local links. Returns all categories in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/get_indie_bestsellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_indie_next_list

Retrieve the current monthly Indie Next List recommendations. Returns the featured #1 Great Read with a bookseller quote, plus a list of recommended books with titles, authors, images, and buy-local links.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/get_indie_next_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_books

Search for books by keyword, title, author, or ISBN on IndieBound.org. Returns up to 10 results per page with book titles, authors, ISBNs, format/publisher info, and buy-local links. Pagination starts at page 0.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination, starting at 0. |
| `query` | string | Yes | Search keyword, title, author name, or ISBN to search for. |
| `search_by` | string | No | Filter search by a specific field. Accepted values: 'title', 'author', 'isbn'. Omitting searches all fields. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-indiebound-org-api-34104d08/search_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","search_by":"<string>"}'
```