# Etilbudsavis — 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 retail offers and product deals from Norwegian stores, browse weekly catalogs, and discover what is currently on sale. Find store locations, view their latest publications, and get detailed information about specific offers all in one place.

**Category:** E-commerce | **Website:** [etilbudsavis.no/](https://etilbudsavis.no/) | **Docs:** [parse.bot/marketplace/9fd6ea15-1bca-495f-b4f3-e8541ca13229/etilbudsavis-no-api](https://parse.bot/marketplace/9fd6ea15-1bca-495f-b4f3-e8541ca13229/etilbudsavis-no-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-etilbudsavis-no-api-9fd6ea15/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_homepage_categories

Returns all top-level store categories and their flyers from the homepage. Each category groups publications by retail segment (groceries, DIY, house and garden, etc.).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etilbudsavis-no-api-9fd6ea15/get_homepage_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_offer_detail

Returns full detail for a single offer within a publication. The offer is identified by its ID within the context of a specific publication.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | The offer ID from get_publication_offers |
| `publication_id` | string | Yes | The publication ID the offer belongs to |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etilbudsavis-no-api-9fd6ea15/get_offer_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offer_id":"<string>","publication_id":"<string>"}'
```

### get_publication_offers

Returns all structured offers within a publication/flyer. Paginates through all pages automatically. Each offer includes pricing, validity dates, and page position within the catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `publication_id` | string | Yes | The publication/flyer ID as returned by get_store_publications or get_homepage_categories |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etilbudsavis-no-api-9fd6ea15/get_publication_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"publication_id":"<string>"}'
```

### get_store_publications

Returns all current and upcoming flyers/publications for a specific store. Each publication represents a weekly catalog with offers valid during a defined date range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_slug` | string | Yes | The slug of the store (e.g. 'SPAR', 'Bunnpris', '7-Eleven', 'KIWI') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etilbudsavis-no-api-9fd6ea15/get_store_publications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_slug":"<string>"}'
```

### list_all_stores

Returns the complete list of all retail stores and brands available on the platform. Each store has a unique slug used to fetch its publications.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etilbudsavis-no-api-9fd6ea15/list_all_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_offers

Full-text search for product offers across all stores by keyword. Returns matching offers from current and upcoming publications with pricing and validity dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for product offers (e.g. 'melk', 'kaffe', 'ost') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etilbudsavis-no-api-9fd6ea15/search_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```