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

> Find synonyms, antonyms, related words, and usage examples for any word instantly. Look up the daily word of the day to expand your vocabulary every day.

**Category:** Education | **Website:** [thesaurus.com/](https://thesaurus.com/) | **Docs:** [parse.bot/marketplace/571af6d0-bec8-4181-b94e-46418eca7af0/thesaurus-com-api](https://parse.bot/marketplace/571af6d0-bec8-4181-b94e-46418eca7af0/thesaurus-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/thesaurus/`
**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 word details

Retrieves synonyms, antonyms, usage examples, and related words for a given word. Each sense groups synonyms and antonyms by part of speech and definition, with a numeric similarity score indicating closeness. Related words are drawn from a broader set of associated terms. The total_words_count reflects the headline count displayed on the page. Paginates as a single page — all senses are returned in one response.

**Estimated cost:** Metered

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

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/thesaurus/get-word-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"word":"<string>"}'
```

### Get word of the day

Retrieves the current Word of the Day from Dictionary.com (linked from Thesaurus.com). Returns the headword, its definition, part of speech, an example sentence, pronunciation (phonetics string and optional audio URL), and an explanatory paragraph about the word's meaning and origin. The response reflects whichever word is featured on the current calendar day.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/thesaurus/get-word-of-the-day \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.