Dictionary API


Table of Contents

  1. Overview
  2. Base url
  3. Endpoints
    3.1 Define a Word
    3.2 Random Words
    3.3 Daily Words
    3.4 Related Words
  4. Support

Overview

This API allows the user to access a copy of Webster's Unabridged Dictionary. The user can search words, get random and daily words, get the part of speech of a word, and get similar words. The copy of Webster’s Unabridged Dictionary was obtained from https://www.gutenberg.org/ebooks/29765.

Base URL

https://api.msmc.cc

Endpoints

Define a word

Info

Endpoint: /dictionary/define/:word
Method: GET
Options:

Example Request

Define a Word‘apple’ can be replaced with any word in the dictionary. See glossary.html for complete list
https://api.msmc.cc/api/dictionary/define/apple

Example Response

{
  "word": "APPLE",
  "pos": "n.",
  "definitions": [
    "The fleshy pome or fruit of a rosaceous tree (Pyrus malus) cultivated in numberless varieties in the temperate zones.",
    "Any tree genus Pyrus which has the stalk sunken into the base of the fruit; an apple tree.",
    "Any fruit or other vegetable production resembling, or supposed to resemble, the apple; as, apple of love, or love apple (a tomato), balsam apple, egg apple, oak apple.",
    "Anything round like an apple; as, an apple of gold."
  ]
}

Example Error

Word not found (404)

{
    "message": "word not found",
    "suggestion": "similar words below",
    "similarWords": ["appl", "ape", "apply"]
}

Get Random Word

Info

Endpoint: /dictionary/random
Method: GET
Querys:
You can only use one search query at a time

Example Requests

Random Word
https://api.msmc.cc/api/dictionary/random
Random Noun‘n’ can be replaced with any part of speech. See glossary.html for abbreviations
https://api.msmc.cc/api/dictionary/random?pos=n
Random Word Beginning with A‘a’ can be replaced with any letter
https://api.msmc.cc/api/dictionary/random?letter=a

Example Response

Random Word

{
  "word": "PAPESCENT",
  "pos": "a.",
  "definitions": [
    "Containing or producing pap; like pap. [R.] Arbuthnot."
  ]
}

Random Noun

{
  "word": "TRIALITY",
  "pos": "n.",
  "definitions": [
    "Three united; state of being three. [R.] H. Wharton."
  ]
}

Random word beginning with ‘A’

{
  "word": "AURISCOPY",
  "pos": "n.",
  "definitions": [
    "Examination of the ear by the aid of the auriscope."
  ]
}

Example Errors

Invalid part of speech (404)

{
    "message": "invalid part of speech. options below",
    "suggestion": "a, adv, conj, interj, n, p, prep, pron, v"
}

Invalid letter (400)

{
    "message": "Error: Please provide a valid letter"
}

Get Daily Word

Info

Endpoint: https://api.msmc.cc/api/dictionary/daily
Method: GET
Options:

Example Requests

Pull word of the day
https://api.msmc.cc/api/dictionary/daily
Pull Adverb of the day‘adv’ can be replaced with any part of speech to pull a different daily word, for example the noun of the day. For a complete list of abbreviations, see glossary.html
https://api.msmc.cc/api/dictionary/daily/adv

Example Response

Word of the Day

{
  "word": {
    "word": "SONNITE",
    "pos": "n.",
    "definitions": [
      "See Sunnite."
    ]
  },
  "date": "2025-01-10"
}

Adverb of the Day

{
  "word": {
    "word": "ABACK",
    "pos": "adv.",
    "definitions": [
      "Toward the back or rear; backward. \"Therewith aback she started.\" Chaucer.",
      "Behind; in the rear. Knolles.",
      "Backward against the mast;-said of the sails when pressed by the wind. Totten. To be taken aback. (a) To be driven backward against the mast; -- said of the sails, also of the ship when the sails are thus driven. (b) To be suddenly checked, baffled, or discomfited. Dickens."
    ]
  },
  "date": "2025-01-10"
}

Example Error

Invalid Part of speech

{
    "message": "invalid part of speech. options below",
    "suggestion": "a, adv, conj, interj, n, p, prep, pron, v"
}

Pull Related Words

Info

Endpoint: https://api.msmc.cc/api/dictionary/related/:word
Method: GET
Options:

Details: This endpoint returns words with similar spelling or definitions to the specified word.

Example Request

Get related Words‘apple’ can be replaced with any word in the dictionary, see glossary.html for a complete list
https://api.msmc.cc/api/dictionary/related/apple

Example Response

{
  "word": "APPLE",
  "relatedWords": [
    "ADAM'S APPLE",
    "APPLE",
    "APPLE",
    "APPLE-FACED",
    "APPLE-JACK",
    "APPLE-JOHN",
    "APPLE PIE",
    "APPLE-SQUIRE",
    "CHESS-APPLE",
    "CRAPPLE",
    "DAPPLE",
    "DAPPLE; DAPPLED",
    "DAPPLE",
    "ENGRAPPLE",
    "GRAPPLE",
    "GRAPPLE",
    "GRAPPLE",
    "GRAPPLEMENT",
    "INGRAPPLE",
    "KNAPPLE",
    "MAD-APPLE",
    "OTAHEITE APPLE",
    "PINEAPPLE",
    "SCAPPLE",
    "SCRAPPLE",
    "SEA APPLE",
    "SHELLAPPLE",
    "STRAPPLE",
    "THRAPPLE",
    "VI-APPLE"
  ]
}

Example Errors

Word not found (404)

{
    "message": "word not found",
    "similarWords": ["appl", "ape"]
}

Support

For support, email [email protected]