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

> Access the latest news from Norway's leading broadcaster NRK.no, including front-page stories, category-specific articles, regional news, and breaking news updates through a unified search and browsing interface. Stay informed with full article content, RSS feeds, and real-time news ticker notifications across all major topics.

**Category:** News & Media | **Website:** [nrk.no/](https://nrk.no/) | **Docs:** [parse.bot/marketplace/16367717-48cf-4ed1-807e-396157e07139/nrk-no-api](https://parse.bot/marketplace/16367717-48cf-4ed1-807e-396157e07139/nrk-no-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/nrk/`
**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 article detail

Fetch full article content including body HTML, authors, image, and metadata from NRK's content API. Provide either an article_id or a full article URL; at least one is required. The article_id is extracted from the URL if only a URL is provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | string | No | NRK article ID in format '1.XXXXXXXX' (e.g. '1.17859339') |
| `url` | string | No | Full NRK article URL (e.g. 'https://www.nrk.no/urix/trump_-_-vapenhvilen-forlenges-med-tre-uker-1.17859339') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/get-article-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"article_id":"<string>","url":"<string>"}'
```

### Get category articles

Get articles from a specific NRK category or section RSS feed. Category maps directly to NRK section URL slugs. Returns articles in display order with metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug matching an NRK section. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/get-category-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### Get front page articles

Extract articles from the NRK.no front page RSS feed in display order. Returns the top stories currently featured on nrk.no with title, summary, publication date, categories, and position. Equivalent to get_top_stories_rss.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/get-front-page-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get latest news ticker

Get the latest items from the NRK breaking news ticker on the front page. Returns headline titles extracted from the front page HTML.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/get-latest-news-ticker \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get regional news

Get regional news articles for a specific NRK region. Uses the region's RSS feed. Regions are NRK's geographic section slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Region slug for an NRK geographic section. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/get-regional-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>"}'
```

### Get top stories rss

Fetch and parse the main NRK RSS feed for top stories. Returns the same data as get_front_page_articles — both read the nrk.no/toppsaker.rss feed.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/get-top-stories-rss \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search articles

Search for articles on NRK.no by keyword. Parses the search results page and returns matching articles with title, URL, summary, and date. Supports pagination via from/size parameters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | integer | No | Start index for pagination (0-based offset) |
| `query` | string | Yes | Search keywords |
| `size` | integer | No | Number of results to return per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nrk/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","query":"<string>","size":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.