Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wordnik Word API

Operations on a single English word (definitions, etymologies, examples, pronunciations, related words, frequency, hyphenation, phrases, scrabble score, audio).

Wordnik Word API is one of 5 APIs that Wordnik publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Word. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

This API exposes 11 operations across 11 paths, and defines 20 schemas. It is described by OpenAPI 3.0.3, at version 4.0.

Requests are made against a single base URL, https://api.wordnik.com/v4.

11 operations 11 paths 20 schemas 11 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
4.0
Base URL
https://api.wordnik.com/v4
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

Wordnik Word API declares 2 security schemes for authenticating requests. An API key is passed in the query as api_key (api_key). An API key is passed in the header as auth_token (auth_token). By default, every request must be authenticated.

  • api_key — Wordnik issues per-account API keys; pass via the apikey query parameter on every request.
  • auth_token — User auth token returned by /account.json/authenticate/{username}; required for user-scoped account and word-list operations.

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 11 GET. Each is listed below with its method, path, parameters, and response codes.

Word 11

Operations on a single English word (definitions, etymologies, examples, pronunciations, related words, frequency, hyphenation, phrases, scrabble score, audio).

GET
/word.json/{word}/audio
Fetch Audio Metadata For A Word
getAudio 3 params → 200
GET
/word.json/{word}/definitions
Return Definitions For A Word
getDefinitions 7 params → 200
GET
/word.json/{word}/etymologies
Fetch Etymology Data For A Word
getEtymologies 2 params → 200
GET
/word.json/{word}/examples
Return Examples For A Word
getExamples 5 params → 200
GET
/word.json/{word}/frequency
Return Word Usage Over Time
getWordFrequency 4 params → 200
GET
/word.json/{word}/hyphenation
Return Syllable Information For A Word
getHyphenation 4 params → 200
GET
/word.json/{word}/phrases
Fetch Bi-gram Phrases For A Word
getPhrases 4 params → 200
GET
/word.json/{word}/pronunciations
Return Text Pronunciations For A Word
getTextPronunciations 5 params → 200
GET
/word.json/{word}/relatedWords
Return Related Words From The Word Graph
getRelatedWords 4 params → 200
GET
/word.json/{word}/scrabbleScore
Return The Scrabble Score For A Word
getScrabbleScore 1 param → 200
GET
/word.json/{word}/topExample
Return A Top Example For A Word
getTopExample 2 params → 200

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are Definition (16 properties), AudioFile (14 properties), Example (12 properties), ScoredWord (11 properties). Each schema is shown below with its type and property counts.

Related
object
7 properties
Sentence
object
6 properties
Bigram
object
5 properties
TextPron
object
3 properties
Note
object
4 properties
Citation
object
2 properties
ContentProvider
object
2 properties
ExampleUsage
object
1 property
Label
object
2 properties
Facet
object
2 properties
Frequency
object
2 properties
FrequencySummary
object
5 properties
Example
object
12 properties
ScrabbleScoreResult
object
1 property
ScoredWord
object
11 properties
Syllable
object
3 properties
ExampleSearchResults
object
2 properties
FacetValue
object
2 properties
AudioFile
object
14 properties 1 required
Definition
object
16 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wordnik-word-api-openapi.yml Raw ↑

Other APIs Wordnik publishes across the network.

Wordnik Account API
Wordnik Word List API
Wordnik Word Lists API
Wordnik Words API