# ARD — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

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

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.beta.paywithlocus.com/api/wrapped/credits/ard/get-article-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ard/get-breaking-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ard/get-homepage-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ard/get-latest-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ard/get-mediathek-home \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ard/search-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<string>"}'
```

## Next steps

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