# Cambridge Dictionary — 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 and retrieve English vocabulary definitions, phonetics, example sentences, and themed word lists from Cambridge Dictionary. Also access academic journal articles and their DOIs from Cambridge Core.

**Category:** Education | **Website:** [cambridge.org/](https://cambridge.org/) | **Docs:** [parse.bot/marketplace/75c250de-aecb-46a6-9df3-c5c35d1500be/cambridge-org-api](https://parse.bot/marketplace/75c250de-aecb-46a6-9df3-c5c35d1500be/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-cambridge-org-api-75c250de/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_journal_issue_articles

Get all articles from a Cambridge Core journal issue with their citations and DOIs. Citation and DOI fetching is best-effort; some articles may have empty values. Returns the issue URL, article count, and an array of articles with metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `issue_path` | string | Yes | The journal issue path (e.g. '/core/journals/language-teaching/latest-issue') or full URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cambridge-org-api-75c250de/get_journal_issue_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"issue_path":"<string>"}'
```

### get_vocabulary_entry

Fetch a detailed dictionary entry for a word including definitions, phonetics, part of speech, example sentences, and related topics. Returns structured data parsed from the Cambridge Dictionary page for the given word and dataset.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dataset` | string | No | The dictionary dataset. |
| `word` | string | Yes | The word to look up. |

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

### get_vocabulary_theme

Get themed vocabulary lists from a Cambridge Dictionary topic page. Returns all words associated with the given theme path. Each word includes a direct link to its dictionary entry.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `theme_path` | string | Yes | The topic path (e.g. 'food/types-of-fruit') or full URL (e.g. 'https://dictionary.cambridge.org/topics/food/types-of-fruit/'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cambridge-org-api-75c250de/get_vocabulary_theme \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"theme_path":"<string>"}'
```

### search_vocabulary

Search for vocabulary suggestions using the Cambridge Dictionary autocomplete API. Returns matching words and their search URLs. The server returns up to ~10 suggestions per query prefix.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dataset` | string | No | The dictionary dataset to search in. |
| `query` | string | Yes | Search keyword prefix to autocomplete. |

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