# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nrk-no-api-16367717/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-nrk-no-api-16367717/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-nrk-no-api-16367717/get_category_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-nrk-no-api-16367717/get_front_page_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-nrk-no-api-16367717/get_latest_news_ticker \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-nrk-no-api-16367717/get_regional_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-nrk-no-api-16367717/get_top_stories_rss \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-nrk-no-api-16367717/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","query":"<string>","size":"<integer>"}'
```