# Adlibris — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-adlibris-com-api-c104ea51/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-adlibris-com-api-c104ea51/browse_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-adlibris-com-api-c104ea51/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-adlibris-com-api-c104ea51/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-adlibris-com-api-c104ea51/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","page":"<integer>","page_size":"<integer>","query":"<string>"}'
```
