Awesome Open Source
Awesome Open Source

powerthesaurus-api

Build Coverage Downloads Size

Look up English synonyms, antonyms, and more using powerthesaurus.org: a crowdsourced corpus of nearly 80 million synonyms and 4 million antonyms.

Install

npm:

npm install powerthesaurus-api

Use

var thesaurus = require('powerthesaurus-api')

// Callbacks:
thesaurus('car', function(err, res) {
  if (err) throw err
  console.log(res)
})

// Promises and given a kind:
thesaurus('blue', 'antonyms').then(
  res => {
    console.log(res)
  },
  err => {
    throw err
  }
)

Yields:

[
  {word: 'vehicle', parts: ['noun'], topics: ['carriage', 'transport']},
  {word: 'motorcar', parts: ['noun', 'adjective'], topics: ['vehicle']},
  {word: 'automobile', parts: ['noun', 'adjective'], topics: ['vehicle', 'transport']},
  {word: 'auto', parts: ['noun', 'adjective'], topics: ['transport', 'technology']},
  {word: 'railcar', parts: ['noun'], topics: []},
  // and 45 more entries
]
[
  {word: 'happy', parts: ['adjective'], topics: ['characteristic', 'decency']},
  {word: 'lighthearted', parts: ['adjective'], topics: ['characteristic', 'happiness']},
  {word: 'joyful', parts: ['adjective'], topics: ['characteristic', 'happiness']},
  {word: 'upbeat', parts: ['adjective'], topics: ['characteristic', 'happiness']},
  {word: 'joyous', parts: ['adjective'], topics: ['characteristic', 'happiness']},
  // and 45 more entries
]

API

thesaurus(word[, kind][, callback])

Look up words relating to word.

Parameters
  • word (string) Word to look up
  • kind (Kind, default: 'synonyms') Type of relation between looked up word and related words, can be: 'synonyms', 'antonyms', 'related', 'narrower', 'broader', 'sound_like', 'similar', or 'rhymes'
  • callback (Function, optional) Callback called when done. Returns a promise when not given
Returns

When given a callback, returns nothing and calls callback with either an error or a list of entries. When not given a callback, returns a Promise, that is either resolved with a list of entries or rejected with an error. Up to 50 entries are found by powerthesaurus-api

Entry

Object representing a related word, with the following fields:

  • word (string) does indeed relate to the looked up word
  • parts (string[]) List of parts of speech of this entry. Can include 'adjective', 'adverb', 'conjunction', 'expression', 'idiom', 'interjection', 'noun', 'phrasal verb', 'pronoun', 'preposition', and/or 'verb'
  • topics (string[]) List of topics of this entry

License

MIT Titus Wormer


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Javascript (1,532,221
English (726
Thesaurus (85
Synonyms (78
Rhyme (41
En (27
Antonyms (20
Related (12
Similar (10
Powerthesaurus (2
Related Projects