# Dictionary Cambridge — 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 word definitions, pronunciations, translations, synonyms, and example sentences from Cambridge Dictionary. Search and browse thousands of words, get daily word recommendations, and access specialized business or American English dictionaries.

**Category:** Education | **Website:** [dictionary.cambridge.org/](https://dictionary.cambridge.org/) | **Docs:** [parse.bot/marketplace/88d77034-c0fb-473f-8f48-ec86f4cf9d2c/dictionary-cambridge-org-api](https://parse.bot/marketplace/88d77034-c0fb-473f-8f48-ec86f4cf9d2c/dictionary-cambridge-org-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-dictionary-cambridge-org-api-88d77034/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete

Fetch autocomplete suggestions for a query fragment. Returns word suggestions as the user types, with relative URLs and beta status flags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dataset` | string | No | The dictionary dataset to search within (e.g. 'english', 'english-spanish') |
| `query` | string | Yes | Search query fragment (e.g. 'app', 'happ') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/autocomplete \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dataset":"<string>","query":"<string>"}'
```

### browse_words_by_letter

Browse the English dictionary alphabetically by letter. Returns available alphabetical sub-ranges for the given letter, each with a text label and URL for drilling into that range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | A single letter to browse (a-z) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/browse_words_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### browse_words_by_letter_range

Fetch words within a specific alphabetical sub-range. Use browse_words_by_letter to discover available range slugs for a letter. Returns word entries with their dictionary URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | Yes | The letter (e.g. 'a', 'b') |
| `range_slug` | string | Yes | The range slug from browse_words_by_letter URL (e.g. 'a-and-e', 'baby-boom') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/browse_words_by_letter_range \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>","range_slug":"<string>"}'
```

### get_american_dictionary_entry

Fetch the American English dictionary section of a word entry. Returns entries specifically from the American Dictionary section of the page, with US-only pronunciations and definitions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_american_dictionary_entry \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_available_dictionaries

Enumerate all available dictionary types and codes from the Cambridge Dictionary homepage. Returns dictionary display names with their URL codes for use with get_word_translation.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_available_dictionaries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_business_dictionary_entry

Fetch the Business English dictionary section for a word. Returns entries specifically from the Business English section including specialized business definitions and examples.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up (e.g. 'asset', 'profit', 'market') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_business_dictionary_entry \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_word_collocations

Fetch common collocations (word combinations) for a word, extracted from definition blocks with their example sentences. Returns definitions paired with usage examples showing the word in common combinations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_word_collocations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_word_definition

Fetch a full word entry from the English dictionary. Returns all senses, parts of speech, pronunciations, definitions, and examples for the given word. Each entry includes UK and US pronunciations with IPA transcriptions and audio URLs. Multiple entries may be returned when a word has distinct dictionary sections (e.g. British vs American).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up (e.g. 'apple', 'run', 'happy') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_word_definition \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_word_examples

Fetch extended corpus examples for a word from the Cambridge English Corpus. Falls back to inline definition examples if corpus examples are unavailable. Returns an array of example sentences demonstrating usage.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_word_examples \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_word_of_the_day

Retrieve the current featured Word of the Day from the Cambridge Dictionary homepage. Returns the word and its full definition entry including pronunciations, senses and examples.

**Estimated cost:** Metered

_No parameters required._

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

### get_word_pronunciation

Fetch UK and US IPA phonetic transcriptions and audio links for a word from the dedicated pronunciation page. Returns region-tagged entries with IPA strings and links to MP3/OGG audio files.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_word_pronunciation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_word_thesaurus

Fetch synonyms and antonyms grouped by sense for a word from the Cambridge Thesaurus. Each sense includes a title describing the meaning and arrays of synonyms and antonyms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `word` | string | Yes | The word to look up |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_word_thesaurus \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### get_word_translation

Fetch word translations for a specific bilingual dictionary code. Returns definitions with translations in the target language. Use get_available_dictionaries to discover valid dictionary codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dict_code` | string | No | The bilingual dictionary code (e.g. 'english-spanish', 'english-french'). Use get_available_dictionaries to see all codes. |
| `word` | string | Yes | The word to translate |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/get_word_translation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dict_code":"<string>","word":"<string>"}'
```

### search_words

Search for words in the English dictionary and return matching entries. Returns links to dictionary entries matching the query, including related terms and idioms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-dictionary-cambridge-org-api-88d77034/search_words \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```