# Adlibris — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 and media across Adlibris.com's catalog, view detailed product information with ratings, and read customer reviews to help you make informed purchasing decisions. Browse products by category and filter results to easily find exactly what you're looking for.

**Category:** E-commerce | **Website:** [adlibris.com/](https://adlibris.com/) | **Docs:** [parse.bot/marketplace/c104ea51-075e-425b-9171-a406c76742d3/adlibris-com-api](https://parse.bot/marketplace/c104ea51-075e-425b-9171-a406c76742d3/adlibris-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/adlibris/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Browse category

Browse a category or top list page on the /sv/ section of Adlibris. Parses the Next.js RSC payload to extract product listings. Returns products with title, author, price, ISBN, format, categories, and stock status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | No | Category or top list URL (e.g. 'https://www.adlibris.com/sv/topplistor'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/adlibris/browse-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get product detail

Get detailed information for a specific product by its full URL. Extracts JSON-LD structured data from the product page including title, author, price, ISBN, description, publisher, language, and publication date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL (e.g. 'https://www.adlibris.com/sv/bok/harry-potter-och-de-vises-sten-9789129697704'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/adlibris/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get product reviews

Get customer reviews for a specific product by its ISBN. Returns an array of reviews with scores, authors, dates, and text extracts from the TestFreaks review aggregation service, plus a URL to fetch the next page of reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `isbn` | string | Yes | Product ISBN (e.g. '9789129723946'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/adlibris/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"isbn":"<string>"}'
```

### Search products

Search the Adlibris catalog via Algolia. Returns paginated product listings with pricing, ratings, and format. Supports keyword search and facet filters. Price is in SEK. Pagination is 1-based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filters` | string | No | Comma-separated Algolia facet filters to apply (e.g. 'language:svenska,format:Inbunden'). |
| `page` | integer | No | Page number for pagination (1-based). |
| `page_size` | integer | No | Number of results per page (max 24). |
| `query` | string | Yes | Search keyword (e.g. 'Harry Potter', 'Dan Brown'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/adlibris/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","page":"<integer>","page_size":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.