# VG — 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 VG.no's latest news, articles, sports scores, and TV guides through a single interface where you can browse the front page, search articles by topic, view category-specific content, and find related stories. Get real-time sports scores and television schedules alongside comprehensive news coverage from Norway's leading news outlet.

**Category:** News & Media | **Website:** [vg.no/](https://vg.no/) | **Docs:** [parse.bot/marketplace/e4a13b7d-fb7a-401d-b0e8-46ce7235e02d/vg-no-api](https://parse.bot/marketplace/e4a13b7d-fb7a-401d-b0e8-46ce7235e02d/vg-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-vg-no-api-e4a13b7d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article

Extract full content from a VG article URL. Returns title, lead, author(s), published date, main image, body text, and summary bullet points (Kortversjonen) when available. Requires a valid VG article URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the VG article (e.g. https://www.vg.no/nyheter/i/abc123/example-article-title). |

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

### get_category_articles

Get articles from a specific VG category. Uses the curate API for sport and HTML parsing for other categories. Returns articles with title and URL; sport articles additionally include published date and authors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug. Verified values: nyheter, sport, rampelys. |

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

### get_front_page

Get an ordered list of articles from the VG homepage. Returns articles with position, title, URL, and optional image URL. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### get_latest_news

Get the most recently published articles from the VG latest news feed at /siste. Returns articles sorted by recency with title, URL, publication time, and reading time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of articles to return. |

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

### get_related_articles

Get related articles for a given VG article URL. Extracts links from the article page's related section or nearby article links. Returns a list of related article titles and URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the VG article to find related articles for. |

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

### get_sport_scores

Get current sports scores and schedules from VG Live. Returns events with teams, scores, and status for a given sport and date. Events are sorted by start time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date for scores in YYYY-MM-DD format. Defaults to today's date. |
| `sport` | string | No | Sport type. Verified values: football, ice-hockey, handball. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vg-no-api-e4a13b7d/get_sport_scores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","sport":"<string>"}'
```

### get_tv_guide

Get the TV schedule for a specific channel and date from the VG TV guide backend. Returns channel metadata and program listings with times, episode details, and rerun status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `channel` | string | No | Channel slug. Verified values: nrk1, nrk2, nrk3, tv2-direkte, tv2-nyheter, tv2-zebra, tvnorge, rex. |
| `date` | string | No | Date in YYYY-MM-DD format. Defaults to today's date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vg-no-api-e4a13b7d/get_tv_guide \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"<string>","date":"<string>"}'
```

### search_articles

Search for articles by keyword on VG.no. Returns matching articles and topic tags from the search results page. Results include title, url, description snippet, and date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword. |

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