# ARD — 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 breaking news, search articles, and browse the latest stories from Germany's leading public broadcasters ARD and Tagesschau, with filtering by region and topic. Retrieve full article details and discover media content from their digital archives.

**Category:** News & Media | **Website:** [ard.de/](https://ard.de/) | **Docs:** [parse.bot/marketplace/b3dd67f0-6774-4f7f-a0f8-91b159845e1d/ard-de-api](https://parse.bot/marketplace/b3dd67f0-6774-4f7f-a0f8-91b159845e1d/ard-de-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-ard-de-api-b3dd67f0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_detail

Fetches full article content by Sophora ID. Returns the complete article including content blocks (HTML text), tags, video, images, and metadata. The sophora_id can be obtained from search results or news feed items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sophora_id` | string | Yes | Sophora ID of the article (e.g. 'nahost-eskalation-usa-iran-100') or a full details API URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ard-de-api-b3dd67f0/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sophora_id":"<string>"}'
```

### get_breaking_news

Fetches articles where the breakingNews flag is true from the latest news feed. Returns an array which may be empty if no breaking news is currently active. Breaking news is rare and time-dependent.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ard-de-api-b3dd67f0/get_breaking_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_homepage_news

Fetches the top/featured news stories and regional news from the Tagesschau homepage. Returns trimmed items with essential metadata including title, date, teaser image, tags, and links. Items are editorially curated and change throughout the day.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ard-de-api-b3dd67f0/get_homepage_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_news

Fetches the latest news articles from the Tagesschau news feed, optionally filtered by ressort (section) or region. Returns the full upstream response including news items and a pagination link to older articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region_id` | integer | No | Filter by region ID (numeric identifier for German states, e.g. 1 for Baden-Württemberg, 2 for Bayern). |
| `ressort` | string | No | Filter by news section. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ard-de-api-b3dd67f0/get_latest_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region_id":"<integer>","ressort":"<string>"}'
```

### get_mediathek_home

Fetches featured content (TV shows, documentaries, livestreams) from the ARD Mediathek homepage. Returns widgets containing categorized teasers for series, films, and editorial picks.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ard-de-api-b3dd67f0/get_mediathek_home \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_news

Searches Tagesschau articles by keyword. Returns paginated search results with total count. Each result includes content preview blocks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-based). |
| `page_size` | integer | No | Number of results per page. |
| `query` | string | Yes | Search keyword (e.g. 'Ukraine', 'Politik', 'Wirtschaft'). |

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