# Etilbudsavis — 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.

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/get-homepage-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/get-offer-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/get-publication-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/get-store-publications \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/list-all-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/etilbudsavis/search-offers \
  -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.