# Wordnik API

> Wordnik API on Apizie: 16 endpoints (Fetches audio metadata for a word., Return definitions for a word, Fetches etymology data, Returns examples for a word, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ai:wordnik/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:wordnik`
- Category: Artificial Intelligence
- Status: byok
- Source: https://wordnik.com
- Page: https://apizie.tech/api/ai/wordnik
- OpenAPI: https://apizie.tech/api/ai/wordnik/openapi.json

Wordnik is the worlds biggest online English dictionary, by number of words

## Endpoints

### Fetches audio metadata for a word.
`GET https://apizie.tech/v1/ai:wordnik/get-audio` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to get audio for. |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| limit | integer | no | Maximum number of results to return |

### Return definitions for a word
`GET https://apizie.tech/v1/ai:wordnik/get-definitions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to return definitions for |
| limit | integer | no | Maximum number of results to return |
| partOfSpeech | string | no | CSV list of part-of-speech types |
| includeRelated | string | no | Return related words with definitions |
| sourceDictionaries | array | no | Source dictionary to return definitions from. If 'all' is received, results are returned from all sources. If multiple values are received… |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| includeTags | string | no | Return a closed set of XML tags in response |

### Fetches etymology data
`GET https://apizie.tech/v1/ai:wordnik/get-etymologies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to return |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |

### Returns examples for a word
`GET https://apizie.tech/v1/ai:wordnik/get-examples` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to return examples for |
| includeDuplicates | string | no | Show duplicate examples from different sources |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| skip | integer | no | Results to skip |
| limit | integer | no | Maximum number of results to return |

### Returns word usage over time
`GET https://apizie.tech/v1/ai:wordnik/get-word-frequency` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to return |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| startYear | integer | no | Starting Year |
| endYear | integer | no | Ending Year |

### Returns syllable information for a word
`GET https://apizie.tech/v1/ai:wordnik/get-hyphenation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to get syllables for |
| useCanonical | string | no | If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| sourceDictionary | string | no | Get from a single dictionary. Valid options: ahd-5, century, wiktionary, webster, and wordnet. |
| limit | integer | no | Maximum number of results to return |

### Fetches bi-gram phrases for a word
`GET https://apizie.tech/v1/ai:wordnik/get-phrases` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to fetch phrases for |
| limit | integer | no | Maximum number of results to return |
| wlmi | integer | no | Minimum WLMI for the phrase |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |

### Returns text pronunciations for a given word
`GET https://apizie.tech/v1/ai:wordnik/get-text-pronunciations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to get pronunciations for |
| useCanonical | string | no | If true will try to return a correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| sourceDictionary | string | no | Get from a single dictionary |
| typeFormat | string | no | Text pronunciation type |
| limit | integer | no | Maximum number of results to return |

### Given a word as a string, returns relationships from the Word Graph
`GET https://apizie.tech/v1/ai:wordnik/get-related-words` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to fetch relationships for |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |
| relationshipTypes | string | no | Limits the total results per type of relationship type |
| limitPerRelationshipType | integer | no | Restrict to the supplied relationship types |

### Returns the Scrabble score for a word
`GET https://apizie.tech/v1/ai:wordnik/get-scrabble-score` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to get scrabble score for. |

### Returns a top example for a word
`GET https://apizie.tech/v1/ai:wordnik/get-top-example` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| word | string | yes | Word to fetch examples for |
| useCanonical | string | no | If true will try to return the correct word root ('cats' -> 'cat'). If false returns exactly what was requested. |

### Returns a single random WordObject
`GET https://apizie.tech/v1/ai:wordnik/get-random-word` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| hasDictionaryDef | string | no | Only return words with dictionary definitions |
| includePartOfSpeech | string | no | CSV part-of-speech values to include (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition,… |
| excludePartOfSpeech | string | no | CSV part-of-speech values to exclude (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition,… |
| minCorpusCount | integer | no | Minimum corpus frequency for terms |
| maxCorpusCount | integer | no | Maximum corpus frequency for terms |
| minDictionaryCount | integer | no | Minimum dictionary count |
| maxDictionaryCount | integer | no | Maximum dictionary count |
| minLength | integer | no | Minimum word length |
| maxLength | integer | no | Maximum word length |

### Returns an array of random WordObjects
`GET https://apizie.tech/v1/ai:wordnik/get-random-words` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| hasDictionaryDef | string | no | Only return words with dictionary definitions |
| includePartOfSpeech | string | no | CSV part-of-speech values to include (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition,… |
| excludePartOfSpeech | string | no | CSV part-of-speech values to exclude (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition,… |
| minCorpusCount | integer | no | Minimum corpus frequency for terms |
| maxCorpusCount | integer | no | Maximum corpus frequency for terms |
| minDictionaryCount | integer | no | Minimum dictionary count |
| maxDictionaryCount | integer | no | Maximum dictionary count |
| minLength | integer | no | Minimum word length |
| maxLength | integer | no | Maximum word length |
| sortBy | string | no | Attribute to sort by |
| sortOrder | string | no | Sort direction |
| limit | integer | no | Maximum number of results to return |

### Reverse dictionary search
`GET https://apizie.tech/v1/ai:wordnik/reverse-dictionary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | Search term |
| findSenseForWord | string | no | Restricts words and finds closest sense |
| includeSourceDictionaries | string | no | Only include these comma-delimited source dictionaries |
| excludeSourceDictionaries | string | no | Exclude these comma-delimited source dictionaries |
| includePartOfSpeech | string | no | Only include these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun,… |
| excludePartOfSpeech | string | no | Exclude these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition,… |
| minCorpusCount | integer | no | Minimum corpus frequency for terms |
| maxCorpusCount | integer | no | Maximum corpus frequency for terms |
| minLength | integer | no | Minimum word length |
| maxLength | integer | no | Maximum word length |
| expandTerms | string | no | Expand terms |
| includeTags | string | no | Return a closed set of XML tags in response |
| sortBy | string | no | Attribute to sort by |
| sortOrder | string | no | Sort direction |
| skip | string | no | Results to skip |
| limit | integer | no | Maximum number of results to return |

### Searches words
`GET https://apizie.tech/v1/ai:wordnik/search-words` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| allowRegex | string | no | Search term is a Regular Expression |
| query | string | yes | Search query |
| caseSensitive | string | no | Search case sensitive |
| includePartOfSpeech | string | no | Only include these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun,… |
| excludePartOfSpeech | string | no | Exclude these comma-delimited parts of speech (allowable values are noun, adjective, verb, adverb, interjection, pronoun, preposition,… |
| minCorpusCount | integer | no | Minimum corpus frequency for terms |
| maxCorpusCount | integer | no | Maximum corpus frequency for terms |
| minDictionaryCount | integer | no | Minimum number of dictionary entries for words returned |
| maxDictionaryCount | integer | no | Maximum dictionary definition count |
| minLength | integer | no | Minimum word length |
| maxLength | integer | no | Maximum word length |
| skip | integer | no | Results to skip |
| limit | integer | no | Maximum number of results to return |

### Returns a specific WordOfTheDay
`GET https://apizie.tech/v1/ai:wordnik/get-word-of-the-day` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| date | string | no | Fetches by date in yyyy-MM-dd |

## Example
```
curl "https://apizie.tech/v1/ai:wordnik/get-audio" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Wordnik API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ai:wordnik/get-audio with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Wordnik API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Wordnik itself also needs your own key from wordnik.com.

### Can AI agents use the Wordnik API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:wordnik.

### What is the status of the Wordnik API?
Needs your own provider key (bring your own key)