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

> Search for word translations across multiple languages using WordReference's comprehensive dictionary database. Retrieve detailed meanings, usage contexts, grammatical information, and example sentences. Access public vocabulary collections and word-of-the-day features.

**Category:** Education | **Website:** [wordreference.com/](https://wordreference.com/) | **Docs:** [parse.bot/marketplace/ca82c4c4-2a9c-4a86-9d5c-18341d5cd1e7/wordreference-com-api](https://parse.bot/marketplace/ca82c4c4-2a9c-4a86-9d5c-18341d5cd1e7/wordreference-com-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-wordreference-com-api-ca82c4c4/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_translations

Retrieve comprehensive translation data for a word, including multiple meanings organized by translation sections (Principal Translations, Compound Forms, etc.), usage contexts, grammatical information, and example sentences. Each section contains entries with source term, context notes, translation, and bilingual examples. Returns stale_input if the word is not found in the specified dictionary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dict` | string | No | Dictionary code specifying the language pair. |
| `word` | string | Yes | The vocabulary word to translate. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wordreference-com-api-ca82c4c4/get_translations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dict":"<string>","word":"<string>"}'
```

### get_vocab_from_list

Fetch all words and their translations or descriptions from a specific public vocabulary list on WordReference. Each word entry includes the vocabulary term and a description or translation. The list_id is obtainable from the list_vocab_lists endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `list_id` | string | Yes | The ID of the vocabulary list, obtainable from list_vocab_lists endpoint (e.g., 'Spanish-List.2998'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wordreference-com-api-ca82c4c4/get_vocab_from_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"list_id":"<string>"}'
```

### get_word_of_the_day

Get the latest Word of the Day terms from WordReference. Returns the current featured words.

**Estimated cost:** Metered

_No parameters required._

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

### list_vocab_lists

List available public vocabulary collections on WordReference. Returns names, IDs, and URLs for each list. Use the returned list ID with get_vocab_from_list to fetch the words in a specific collection.

**Estimated cost:** Metered

_No parameters required._

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

### search_words

Search for word suggestions using the WordReference autocomplete API. Returns matching words with their language code and occurrence count. Useful for building typeahead/autocomplete UIs or discovering word forms (plurals, conjugations). Results are ordered by occurrence frequency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dict` | string | No | Dictionary code specifying the language pair. |
| `limit` | integer | No | Maximum number of suggestions to return. |
| `query` | string | Yes | The search term to find suggestions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wordreference-com-api-ca82c4c4/search_words \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dict":"<string>","limit":"<integer>","query":"<string>"}'
```