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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/`
**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

### 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.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/get-blowouts-daily-deal \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/get-bstock-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/get-bstock-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/get-bstock-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/get-bstock-subcategories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/thomann-portugal/search-bstock-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.