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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/wordreference/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/wordreference/get-translations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/wordreference/get-vocab-from-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/wordreference/get-word-of-the-day \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/wordreference/list-vocab-lists \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/wordreference/search-words \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"dict":"<string>","limit":"<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.