# Adidas (Germany) — 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 and browse Adidas products on adidas.de to find detailed information about items, availability, pricing, and specific categories. Get comprehensive product details including size availability and stock levels across the German Adidas store.

**Category:** E-commerce | **Website:** [adidas.de/](https://adidas.de/) | **Docs:** [parse.bot/marketplace/16b6cfa2-f0aa-4b3a-b906-310a16e00d64/adidas-de-api](https://parse.bot/marketplace/16b6cfa2-f0aa-4b3a-b906-310a16e00d64/adidas-de-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-adidas-de-api-16b6cfa2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_category

Browse products within a specific category on adidas.de. Returns paginated results with product names, prices, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category to browse (e.g. 'shoes', 'clothing', 'accessories') |
| `gender` | string | No | Filter by gender |
| `size` | string | No | Filter by size |
| `start` | integer | No | Pagination start index |
| `sz` | integer | No | Number of results per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adidas-de-api-16b6cfa2/browse_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","gender":"<string>","size":"<string>","start":"<integer>","sz":"<integer>"}'
```

### get_product_availability

Check real-time stock availability and sizes for a product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product ID (e.g. KC8639) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adidas-de-api-16b6cfa2/get_product_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_product_details

Retrieve full product details including description, images, pricing, attributes, and available size variations for a specific product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product ID from search or browse results (e.g. 'IF6490') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adidas-de-api-16b6cfa2/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### search_products

Search for products on adidas.de using keywords and optional filters for gender and size. Returns paginated results with product names, prices, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Filter by gender: 'manner', 'frauen', 'kinder', 'unisex' |
| `query` | string | No | Search keyword (e.g. 'shoes', 'running', 't-shirt') |
| `size` | string | No | Filter by size, lowercase (e.g. 'xs', 's', 'm', 'l', 'xl', '2xl', '3xl', '42', '44') |
| `start` | integer | No | Pagination start index |
| `sz` | integer | No | Number of results per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adidas-de-api-16b6cfa2/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gender":"<string>","query":"<string>","size":"<string>","start":"<integer>","sz":"<integer>"}'
```
