vocabulary: "1.0.0"
info:
provider: "Wordnik"
description: >-
Unified taxonomy of the Wordnik v4 dictionary API. Maps the operational dimension
(28 HTTP operations over 24 paths in one OpenAPI spec) to the capability dimension
(5 self-contained Naftiko capabilities — Word, Words, Word List, Word Lists, Account).
created: "2026-05-29"
modified: "2026-05-29"
operational:
apis:
- name: Wordnik
namespace: wordnik
version: "4.0"
baseUrl: https://api.wordnik.com/v4
status: active
resources:
- name: word
api: Wordnik
description: A single dictionary word and everything Wordnik knows about it.
actions: [getDefinitions, getEtymologies, getExamples, getTopExample, getHyphenation, getPronunciations, getRelatedWords, getFrequency, getPhrases, getScrabbleScore, getAudio]
- name: words
api: Wordnik
description: Cross-word discovery — random words, search, reverse dictionary, word of the day.
actions: [getRandomWord, getRandomWords, searchWords, reverseDictionary, getWordOfTheDay]
- name: wordList
api: Wordnik
description: A single user-owned curated list of words identified by permalink.
actions: [getByPermalink, update, delete, listWords, addWords, deleteWords]
- name: wordLists
api: Wordnik
description: The user's collection of word lists; the creation surface.
actions: [create]
- name: account
api: Wordnik
description: API-key telemetry plus user authentication and ownership.
actions: [getApiTokenStatus, authenticate, authenticatePost, getLoggedInUser, getWordLists]
actions:
- name: get
pattern: read
httpMethod: GET
- name: list
pattern: read
httpMethod: GET
- name: search
pattern: query
httpMethod: GET
- name: create
pattern: write
httpMethod: POST
- name: update
pattern: write
httpMethod: PUT
- name: delete
pattern: destructive
httpMethod: DELETE
- name: authenticate
pattern: write
httpMethod: GET
schemas:
core:
- WordObject
- Definition
- SimpleDefinition
- Example
- SimpleExample
- ExampleSearchResults
- WordOfTheDay
- WordSearchResult
- WordSearchResults
- DefinitionSearchResults
lexical:
- PartOfSpeech
- Syllable
- TextPron
- AudioFile
- AudioType
- Bigram
- Related
- Root
- Category
- Label
- Note
- Citation
- ScoredWord
- Sentence
- Frequency
- FrequencySummary
- ExampleUsage
- ContentProvider
- Facet
- FacetValue
user:
- User
- WordList
- WordListWord
- StringValue
account:
- ApiTokenStatus
- AuthenticationToken
- ScrabbleScoreResult
parameters:
pagination:
- skip
- limit
identifiers:
- word
- permalink
- username
- query
- date
filters:
- partOfSpeech
- includePartOfSpeech
- excludePartOfSpeech
- relationshipTypes
- sourceDictionary
- sourceDictionaries
- includeSourceDictionaries
- excludeSourceDictionaries
- hasDictionaryDef
- typeFormat
- useCanonical
- includeRelated
- includeDuplicates
- includeTags
- caseSensitive
- allowRegex
- expandTerms
measurement:
- minCorpusCount
- maxCorpusCount
- minDictionaryCount
- maxDictionaryCount
- minLength
- maxLength
- startYear
- endYear
- wlmi
- limitPerRelationshipType
sort:
- sortBy
- sortOrder
authentication:
- api_key
- auth_token
- password
enums:
partOfSpeech: [noun, adjective, verb, adverb, interjection, pronoun, preposition, abbreviation, affix, article, auxiliary-verb, conjunction, definite-article, family-name, given-name, idiom, imperative, noun-plural, noun-posessive, past-participle, phrasal-prefix, proper-noun, proper-noun-plural, proper-noun-posessive, suffix, verb-intransitive, verb-transitive]
sourceDictionary: [ahd-5, century, cmu, macmillan, wiktionary, webster, wordnet, all]
relationshipType: [synonym, antonym, variant, equivalent, cross-reference, related-word, rhyme, form, etymologically-related-term, hypernym, hyponym, inflected-form, primary, same-context, verb-form, verb-stem, has_topic]
typeFormat: [ahd-5, arpabet, gcide-diacritical, IPA]
sortBy: [alpha, count, createDate]
sortOrder: [asc, desc]
wordListType: [PUBLIC, PRIVATE]
authentication:
schemes:
- name: api_key
type: apiKey
location: query
scope: all-endpoints
notes: Issued per Wordnik account; required on every request.
- name: auth_token
type: apiKey
location: header
scope: user-endpoints
notes: Obtained from /account.json/authenticate; required for /account.json/user, /account.json/wordLists, and all /wordList.json / /wordLists.json operations.
capability:
workflows:
- name: Wordnik — Word
file: capabilities/wordnik-word.yaml
apis: [Wordnik]
operations: 11
personas: [App Developer, Linguistics Researcher, Educator]
domains: [Dictionary, Lexicography]
- name: Wordnik — Words
file: capabilities/wordnik-words.yaml
apis: [Wordnik]
operations: 5
personas: [App Developer, Game Developer, Content Writer]
domains: [Dictionary, Discovery]
- name: Wordnik — Word List
file: capabilities/wordnik-word-list.yaml
apis: [Wordnik]
operations: 6
personas: [End User, Educator, Vocabulary Coach]
domains: [Personalization, Collections]
- name: Wordnik — Word Lists
file: capabilities/wordnik-word-lists.yaml
apis: [Wordnik]
operations: 1
personas: [End User, Educator]
domains: [Personalization, Collections]
- name: Wordnik — Account
file: capabilities/wordnik-account.yaml
apis: [Wordnik]
operations: 5
personas: [App Developer, Platform Owner]
domains: [Authentication, Telemetry]
personas:
- id: app-developer
name: App Developer
description: Integrates Wordnik definitions, examples, and audio into a consumer app or website.
workflows: [Wordnik — Word, Wordnik — Words, Wordnik — Account]
- id: game-developer
name: Game Developer
description: Uses random words, scrabble scores, and search for word-based games.
workflows: [Wordnik — Words, Wordnik — Word]
- id: educator
name: Educator
description: Curates vocabulary lists for students.
workflows: [Wordnik — Word List, Wordnik — Word Lists, Wordnik — Word]
- id: linguistics-researcher
name: Linguistics Researcher
description: Studies word frequency over time, related-word graphs, and etymology.
workflows: [Wordnik — Word]
- id: end-user
name: End User
description: A Wordnik member curating their own word collections.
workflows: [Wordnik — Word List, Wordnik — Word Lists]
- id: platform-owner
name: Platform Owner
description: Operates a Wordnik integration; monitors quota and user authentication.
workflows: [Wordnik — Account]
- id: content-writer
name: Content Writer
description: Uses reverse-dictionary lookup and word-of-the-day for editorial workflows.
workflows: [Wordnik — Words]
- id: vocabulary-coach
name: Vocabulary Coach
description: Builds and edits shared word lists for learners.
workflows: [Wordnik — Word List]
domains:
- name: Dictionary
description: Core English dictionary surface — definitions, etymologies, examples.
- name: Lexicography
description: Word-graph relationships, frequency, hyphenation, pronunciation.
- name: Discovery
description: Random words, search, reverse dictionary, word of the day.
- name: Personalization
description: User-owned word lists and curation.
- name: Collections
description: Word-list inventory and word-membership management.
- name: Authentication
description: User auth tokens and identity.
- name: Telemetry
description: API key status, quota visibility.
namespaces:
- consumed: wordnik-word
restExposed: wordnik-word-rest
mcpExposed: wordnik-word-mcp
restPort: 8080
mcpPort: 9090
- consumed: wordnik-words
restExposed: wordnik-words-rest
mcpExposed: wordnik-words-mcp
restPort: 8080
mcpPort: 9090
- consumed: wordnik-word-list
restExposed: wordnik-word-list-rest
mcpExposed: wordnik-word-list-mcp
restPort: 8080
mcpPort: 9090
- consumed: wordnik-word-lists
restExposed: wordnik-word-lists-rest
mcpExposed: wordnik-word-lists-mcp
restPort: 8080
mcpPort: 9090
- consumed: wordnik-account
restExposed: wordnik-account-rest
mcpExposed: wordnik-account-mcp
restPort: 8080
mcpPort: 9090
binds:
- name: WORDNIK_API_KEY
description: Wordnik per-account API key; sent as ?api_key= query parameter on every request.
workflows: [Wordnik — Word, Wordnik — Words, Wordnik — Word List, Wordnik — Word Lists, Wordnik — Account]
- name: WORDNIK_AUTH_TOKEN
description: User auth token returned by /account.json/authenticate/{username}; required for user-scoped surfaces.
workflows: [Wordnik — Word List, Wordnik — Word Lists, Wordnik — Account]
crossReference:
- resource: word
operations: [getDefinitions, getEtymologies, getExamples, getTopExample, getHyphenation, getPronunciations, getRelatedWords, getFrequency, getPhrases, getScrabbleScore, getAudio]
workflows: [Wordnik — Word]
personas: [App Developer, Game Developer, Educator, Linguistics Researcher]
- resource: words
operations: [getRandomWord, getRandomWords, searchWords, reverseDictionary, getWordOfTheDay]
workflows: [Wordnik — Words]
personas: [App Developer, Game Developer, Content Writer]
- resource: wordList
operations: [getByPermalink, update, delete, listWords, addWords, deleteWords]
workflows: [Wordnik — Word List]
personas: [End User, Educator, Vocabulary Coach]
- resource: wordLists
operations: [create]
workflows: [Wordnik — Word Lists]
personas: [End User, Educator]
- resource: account
operations: [getApiTokenStatus, authenticate, authenticatePost, getLoggedInUser, getWordLists]
workflows: [Wordnik — Account]
personas: [App Developer, Platform Owner]