Thesaurus API

The Thesaurus API allows you to look up synonyms (similar words) and antonyms (opposite-meaning words) for any English word.

/v1/thesaurus

HTTP GET

Returns a list of synonyms and a list of antonyms for a given word.

Parameters

word (required) - word to look up.

Headers

X-Api-Key (required) - API Key associated with your account.

Sample Request URL

Live Demo!

https://api.api-ninjas.com/v1/thesaurus?word=

Sample Response

{
  "word": "elegant",
  "synonyms": [
    "graceful",
    "handsome",
    "fine",
    "luxurious",
    "majestic",
    "magnificent",
    "classy",
    "stylish",
    "simple",
    "tasteful",
    "glorious",
    "proud",
    "royal",
    "superb",
    "regal",
    "refined",
    "rich",
    "sophisticated",
    "aristocratic",
    "noble",
    "gallant",
    "courtly",
    "stately",
    "fashionable",
    "exquisite",
    "grand",
    "quiet",
    "lavish",
    "ornate",
    "sleek",
    "polished",
    "heroic",
    "splendid",
    "classic",
    "monumental",
    "heroical",
    "imposing",
    "artful",
    "chic",
    "conservative",
    "restrained",
    "understated",
    "baronial",
    "genteel",
    "posh",
    "swanky",
    "smart",
    "patrician",
    "august",
    "swank",
    "grandiose",
    "ostentatious",
    "pretentious",
    "modish",
    "in",
    "sharp",
    "snappy",
    "a la mode",
    "affected",
    "recherché",
    "swagger",
    "à la mode"
  ],
  "antonyms": [
    "inelegant",
    "unfashionable",
    "tasteless",
    "unhandsome",
    "dowdy",
    "graceless",
    "loud",
    "grotesque",
    "flamboyant",
    "flashy",
    "gaudy",
    "unstylish",
    "crude",
    "coarse",
    "tawdry",
    "glitzy",
    "tacky",
    "garish",
    "cheesy",
    "raffish",
    "splashy",
    "styleless",
    "vulgar",
    "unpolished",
    "uncouth",
    "trashy",
    "unrefined",
    "rude",
    "uncultivated",
    "rough-hewn",
    "uncultured",
    "ticky-tacky",
    "ticky-tack",
    "rough-edged"
  ]
}


import requests

word = 'bright'
api_url = 'https://api.api-ninjas.com/v1/thesaurus?word={}'.format(word)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
    print(response.text)
else:
    print("Error:", response.status_code, response.text)
var word = 'bright'
$.ajax({
    method: 'GET',
    url: 'https://api.api-ninjas.com/v1/thesaurus?word=' + word,
    headers: { 'X-Api-Key': 'YOUR_API_KEY'},
    contentType: 'application/json',
    success: function(result) {
        console.log(result);
    },
    error: function ajaxError(jqXHR) {
        console.error('Error: ', jqXHR.responseText);
    }
});
const request = require('request');
var word = 'bright';
request.get({
  url: 'https://api.api-ninjas.com/v1/thesaurus?word=' + word,
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
}, function(error, response, body) {
  if(error) return console.error('Request failed:', error);
  else if(response.statusCode != 200) return console.error('Error:', response.statusCode, body.toString('utf8'));
  else console.log(body)
});
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import com.fasterxml.jackson.databind.ObjectMapper;

URL url = new URL("https://api.api-ninjas.com/v1/thesaurus?word=bright");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestProperty("accept", "application/json");
InputStream responseStream = connection.getInputStream();
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(responseStream);
System.out.println(root.path("fact").asText());
let word = "bright".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)
let url = URL(string: "https://api.api-ninjas.com/v1/thesaurus?word=" + word!)!
var request = URLRequest(url: url)
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
    guard let data = data else { return }
    print(String(data: data, encoding: .utf8)!)
}
task.resume()
If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.