v2.4 Stable

Build with the Dictionary API

Access 15M+ words, real-time definitions, phonetics, translations, and AI-powered linguistic insights in under 50ms. Designed for developers, scaled for the world.

Generate API Key Read Full Docs →

🔒 REST & GraphQL ⚡ 99.99% Uptime 📦 12 SDKs

request.js

const response = await fetch("https://api.dictionary.dev/v2/words/ephemeral", {
  headers: {
    "Authorization": `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data.meaning[0].definitions[0].definition);
// Output: "Lasting for a very short time; transitory."

qwen

Quick Start

Get up and running in 3 steps

Create an Account

Generate Your Key

Head to the dashboard and create a secret API key. Keep it secure and never expose it in client-side code.

Make Your First Request

Use your key in the Authorization header and start querying definitions, synonyms, and translations instantly.

API Reference

Authentication & Endpoints

Secure your requests with Bearer tokens. All endpoints return structured JSON with consistent error handling.

Authentication

Include your API key in the Authorization header as a Bearer token. Keys are scoped to your account tier and automatically rotate for security.

headers

"Authorization": "Bearer sk_dict_live_9x8v7c6b5n4m3"
"X-Request-ID": "req_2f9a1b8c" /* optional */

✅ CORS Enabled ✅ HTTPS Only ✅ Rate Limited

Method	Endpoint	Description
GET	/v2/words/{term}	Fetch definitions, phonetics & examples
GET	/v2/words/search	Fuzzy search with filters
GET	/v2/synonyms/{term}	Get related words & antonyms
POST	/v2/translate	Context-aware translations
PUT	/v2/custom/{dict_id}	Update custom dictionaries

View Complete Reference →

Examples

Integrate in your language

node.js

const Dictionary = require("@dictionary/sdk");
const client = new Dictionary(process.env.DICT_API_KEY);

async function lookup() {
  const res = await client.words.get("serendipity", {
    lang: "en",
    include: ["phonetics", "examples"]
  });
  console.log(res.phonetics[0].text);
}
lookup();

python

import dictionary_sdk

client = dictionary_sdk.Client("sk_dict_live_...")
response = client.words.get(
    term="serendipity",
    lang="en",
    include=["phonetics", "examples"]
)
print(response["phonetics"][0]["text"])

bash

curl "https://api.dictionary.dev/v2/words/serendipity" \
  -H "Authorization: Bearer sk_dict_live_..." \
  -H "Accept: application/json"

php

<?php
require 'vendor/autoload.php';

use Dictionary\Client;

$client = new Client(getenv('DICT_API_KEY'));
$word = $client->words->get('serendipity');
echo $word['phonetics'][0]['text'];