# Elkjop — 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 Elkjøp Norway's complete product catalog with live pricing, specifications, and customer reviews, while checking real-time stock availability and delivery options across store locations. Discover weekly deals, outlet products, and recommended accessories to make informed shopping decisions.

**Category:** E-commerce | **Website:** [elkjop.no/](https://elkjop.no/) | **Docs:** [parse.bot/marketplace/aeef0664-94ed-4504-8ad7-964f27b2baec/elkjop-no-api](https://parse.bot/marketplace/aeef0664-94ed-4504-8ad7-964f27b2baec/elkjop-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-elkjop-no-api-aeef0664/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### check_delivery_availability

Check product sellability and delivery availability for a given postal code. Returns stock status, online availability, and delivery options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `postal_code` | string | Yes | Norwegian postal code (e.g. 0150, 1461) |
| `product_id` | string | Yes | Product SKU/article number (e.g. 911981) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/check_delivery_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"postal_code":"<string>","product_id":"<string>"}'
```

### get_categories

Get top-level product categories with product counts from the Elkjop catalog. Returns hierarchical category names derived from product taxonomy facets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Category ID for subcategories (currently unused; omit to get top-level categories) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>"}'
```

### get_category_listing

Get product listings for a specific category path. The path should match an elkjop.no category URL path segment. Extracts taxonomy filter from the category page HTML and queries the Algolia index. Paginates via page number; each page contains up to 48 products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_path` | string | Yes | Category URL path starting with /, e.g. /mobil-nettbrett-og-smartklokker/mobiltelefon |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_category_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_path":"<string>","page":"<integer>"}'
```

### get_outlet_products

Get outlet/used/returned products. These are products in the Outlet taxonomy (returned, display models, or slightly damaged items sold at reduced prices). Includes bItem grade info. Paginates via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_outlet_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product_accessories

Get recommended/compatible accessories and bundle offers for a product. Returns bundle promotions with discounted accessory items, qualifying articles, and pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product SKU/article number (e.g. 911981) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_product_accessories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_product_details

Get comprehensive product details including Algolia catalog data (title, brand, price, stock, attributes), pricing from the product API (sellability, availability), and reviews summary from Feefo. Returns a single merged product object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product SKU/article number (e.g. 911981) |

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

### get_product_reviews

Get customer reviews for a product from the Feefo review platform. Returns paginated reviews with ratings, review text, and product info. Each page contains up to 20 reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |
| `product_id` | string | Yes | Product SKU/article number (e.g. 911981) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","product_id":"<string>"}'
```

### get_product_specifications

Get technical specifications for a product by parsing the product page HTML. Returns specifications grouped by category (e.g. 'Mål og vekt', 'Tilkobling'). Each category maps to an object of spec key-value pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product SKU/article number (e.g. 911981) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_product_specifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_store_details

Get detailed information for a specific store including full opening hours, address with coordinates, and available services. Store slug must be sourced from get_stores response URLs (the segment after /store/).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_slug` | string | Yes | Store URL slug from get_stores (e.g. elkjop-storo, elkjop-lorenskog) |

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

### get_stores

Get all Elkjop store locations with addresses, opening hours, and service information. Returns the full list of stores in Norway.

**Estimated cost:** Metered

_No parameters required._

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

### get_weekly_deals

Get current weekly campaign/deal products. Returns products that have active campaign pricing (discounted items with before/after prices). Paginates via page number; each page contains up to 48 products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-elkjop-no-api-aeef0664/get_weekly_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_products

Full-text search over Elkjop's product catalog. Returns paginated results with product title, price, brand, article number, stock info, and ratings. Paginates via page number; each page contains up to 48 products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based) |
| `query` | string | Yes | Search keyword (e.g. 'laptop', 'Samsung', 'TV') |

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