# Hood — 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 and search thousands of products on hood.de, view detailed product information, explore categories, and discover current deals—all with autocomplete suggestions to help you find exactly what you're looking for. Get real-time access to pricing, availability, and special offers from Germany's popular online marketplace.

**Category:** Marketplaces | **Website:** [hood.de/](https://hood.de/) | **Docs:** [parse.bot/marketplace/fa5241fe-e8d2-4c62-8383-fb1145214990/hood-de-api](https://parse.bot/marketplace/fa5241fe-e8d2-4c62-8383-fb1145214990/hood-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-hood-de-api-fa5241fe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_autocomplete_suggestions

Get search autocomplete suggestions for a partial query term. Returns matching search terms (with popularity flags), relevant categories, and manufacturers from hood.de's suggestion API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search term to get suggestions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hood-de-api-fa5241fe/get_autocomplete_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_categories

Retrieve the full category hierarchy from hood.de. Returns an array of top-level categories, each with a name and a list of subcategories (name + URL). Useful for discovering category_id values for filtered search.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hood-de-api-fa5241fe/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hood_deals

Retrieve featured deals from the Hood Deals page. Returns an array of deal items currently promoted on the site, each with title, URL, price, optional discount percentage, and image.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hood-de-api-fa5241fe/get_hood_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Fetch full details for a single product by its hood.de URL. Returns price, condition, brand, EAN, images, structured properties, and the full description text (including content from the product's description iframe). Returns stale_input if the product page no longer exists (404/410).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the product page on hood.de (e.g. https://www.hood.de/i/product-name-12345678.htm). |

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

### search_products

Full-text search across hood.de listings. Filters by condition (new/used/both) and category. Returns up to 48 products per page sorted by relevance. Each product includes id, title, price, image, seller type, and rating summary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID to filter by. 0 means all categories. |
| `condition` | string | No | Filter by item condition. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hood-de-api-fa5241fe/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","condition":"<string>","page":"<integer>","query":"<string>"}'
```