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

> Look up German words with detailed definitions, pronunciations, and usage examples, or explore curated word lists organized by proficiency level. Search vocabulary, discover random entries, and learn the featured word of the day to build your German language skills.

**Category:** Education | **Website:** [dwds.de/](https://dwds.de/) | **Docs:** [parse.bot/marketplace/c2ed1f24-1390-46e9-ab8b-0291e7d60354/dwds-de-api](https://parse.bot/marketplace/c2ed1f24-1390-46e9-ab8b-0291e7d60354/dwds-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-dwds-de-api-c2ed1f24/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_of_the_day

Retrieve the DWDS Word of the Day entries from the Atom feed. Returns the most recent 15 entries with title, link, and update date. The summary field is currently null for all entries.

**Estimated cost:** Metered

_No parameters required._

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

### get_goethe_a1_word_list

Fetch the complete Goethe-Zertifikat A1 vocabulary list. Returns all ~650 entries with part of speech, lemma, URL, and grammatical information (gender, articles). No pagination — the full list is returned in one call.

**Estimated cost:** Metered

_No parameters required._

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

### get_random_entries

Get 5 random dictionary entries from DWDS. Each entry includes the lemma, part of speech, article date, entry type, and grammatical metadata. Results vary on every call.

**Estimated cost:** Metered

_No parameters required._

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

### get_word_details

Get detailed information for a specific German word. Assembles data from multiple DWDS sources: IPA pronunciation from the phonetics API, frequency class from the frequency API, and meanings/examples/grammar/audio from the dictionary article page. Returns null for IPA and frequency when unavailable. A 404 on the article page yields input_not_found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The German word to look up (e.g. Haus, gehen, Wasser). |

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

### search_word

Search for word snippets and metadata in the DWDS dictionary. Returns matching entries with the canonical lemma, part of speech, and URL. Useful for autocomplete or verifying whether a word exists before fetching full details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query term (e.g. Haus, gehen). |

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