# Abebooks — 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.

> Search for books by title or ISBN, view detailed listing information, and discover available sellers offering new and used copies. Find the best deals by comparing prices across multiple sellers and browsing their inventory.

**Category:** Marketplaces | **Website:** [abebooks.com/](https://abebooks.com/) | **Docs:** [parse.bot/marketplace/098bce80-9a48-495e-9789-46bd8f1c91b7/abebooks-com-api](https://parse.bot/marketplace/098bce80-9a48-495e-9789-46bd8f1c91b7/abebooks-com-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-abebooks-com-api-098bce80/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_book_listing

Retrieve detailed information for a specific book listing including title, author, price, condition, ISBNs, publisher, and seller details. Returns stale_input if the listing no longer exists.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_id` | string | Yes | AbeBooks listing ID (numeric string). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-abebooks-com-api-098bce80/get_book_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"listing_id":"<string>"}'
```

### get_new_offers

Search for books in New condition only. Returns listings filtered to new copies matching the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-abebooks-com-api-098bce80/get_new_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_used_offers

Search for books in Used condition only. Returns listings filtered to used copies matching the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-abebooks-com-api-098bce80/get_used_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_books

Full-text search over AbeBooks listings by author, title, ISBN, or keyword. Supports condition filtering and sort order. Returns up to 20 results per page. Paginates via integer page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `author` | string | No | Author name. |
| `condition` | string | No | Book condition filter. |
| `isbn` | string | No | Book ISBN (ISBN-10 or ISBN-13). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | General search keyword. |
| `sort` | integer | No | Sort order. |
| `title` | string | No | Book title. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-abebooks-com-api-098bce80/search_books \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"author":"<string>","condition":"<string>","isbn":"<string>","page":"<integer>","query":"<string>","sort":"<integer>","title":"<string>"}'
```

### search_by_isbn

Search for books by ISBN. Returns listings matching the given ISBN-10 or ISBN-13. May return empty results if the ISBN has no active listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `isbn` | string | Yes | ISBN-10 or ISBN-13 to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-abebooks-com-api-098bce80/search_by_isbn \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"isbn":"<string>"}'
```

### search_sellers

Search for sellers by name. Returns matching seller names, profile URLs, and location/specialty information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Seller name or keyword to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-abebooks-com-api-098bce80/search_sellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"<string>"}'
```