# Thomann (Portugal) — 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.

> Browse Thomann's discounted B-Stock and blowout inventory by category or subcategory, search for deals by keyword, and retrieve full product details including specifications, images, pricing, and availability. Also surfaces the current featured daily deal.

**Category:** E-commerce | **Website:** [thomann.pt/](https://thomann.pt/) | **Docs:** [parse.bot/marketplace/73bde884-57e6-4ecf-9a50-b560a81d6b3f/thomann-pt-api](https://parse.bot/marketplace/73bde884-57e6-4ecf-9a50-b560a81d6b3f/thomann-pt-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-thomann-pt-api-73bde884/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_blowouts_daily_deal

Fetches the current featured daily deal products from the Thomann Portugal blowouts page ('Oportunidade do dia' section). Returns product name, price, URL, and image for all currently featured deals. Deals rotate periodically.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thomann-pt-api-73bde884/get_blowouts_daily_deal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_bstock_categories

Fetches all top-level B-Stock/Discounted Bargains categories from the Thomann Portugal blowouts page. Returns a list of category names with item counts and URLs. Categories represent instrument families and equipment types available in the blowouts section.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thomann-pt-api-73bde884/get_bstock_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_bstock_product_detail

Returns full details for a specific product including brand, price, availability, images, and specifications. Use a product URL from get_bstock_products or search_bstock_products. Provides technical specs, product images, and availability status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of a product page from get_bstock_products or search_bstock_products |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thomann-pt-api-73bde884/get_bstock_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_bstock_products

Fetches a paginated list of B-Stock products for a category or subcategory URL. Supports sorting by popularity, price, rating, or newest. Returns product summaries including name, price, URL, image, rating, and review count. Page size is determined by the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for product listing. |
| `url` | string | Yes | Full URL of a blowout category or subcategory page from get_bstock_categories or get_bstock_subcategories |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thomann-pt-api-73bde884/get_bstock_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>","url":"<string>"}'
```

### get_bstock_subcategories

Returns subcategories for a given blowout category URL. Use a category URL from get_bstock_categories to discover narrower product groupings within a top-level category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of a blowout category page from get_bstock_categories (e.g. https://www.thomann.pt/blowouts_GF_guitarras_e_baixos.html) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thomann-pt-api-73bde884/get_bstock_subcategories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_bstock_products

Searches for B-Stock/blowout products by keyword using the site's AJAX API. Returns structured product data including price, availability, rating, and manufacturer. Results are limited to items in the blowouts/B-Stock section.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. Fender, guitar, microphone) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thomann-pt-api-73bde884/search_bstock_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```