Dictionary API - Browse Endpoints

🔍 Dictionary & Search

v1

GET /api/v1/words/{word} Retrieve full definition, phonetics, and usage examples ▾

Name	Type	Required	Description
`word`	string	Required	The exact word to look up
`language`	string	Optional	ISO 639-1 code (default: en)

GET /api/v1/words/ephemeral?language=en
Host: api.dictionary.com
Authorization: Bearer <YOUR_API_KEY>
Accept: application/json

{
  "word": "ephemeral",
  "phonetic": "/əˈfem.ər.əl/",
  "partOfSpeech": "adjective",
  "definitions": [
    {
      "definition": "Lasting for a very short time",
      "example": "The ephemeral beauty of cherry blossoms."
    }
  ],
  "synonyms": ["fleeting", "transient", "momentary"]
}

GET /api/v1/search Fuzzy search and autocomplete suggestions ▾

Name	Type	Required	Description
`q`	string	Required	Search query
`limit`	integer	Optional	Max results (default: 10, max: 50)

GET /api/v1/search?q=ephem&limit=5
Host: api.dictionary.com
Authorization: Bearer <YOUR_API_KEY>

{
  "results": [
    { "word": "ephemeral", "match_score": 0.98 },
    { "word": "ephemera", "match_score": 0.95 },
    { "word": "epithet", "match_score": 0.82 }
  ]
}

🌐 Translation & Synonyms

v1

POST /api/v1/translate Translate text or single words across 100+ languages ▾

Name	Type	Required	Description
`text`	string	Required	Text to translate
`source_lang`	string	Optional	Source language code
`target_lang`	string	Required	Target language code

{
  "text": "ephemeral",
  "source_lang": "en",
  "target_lang": "es"
}

{
  "translated_text": "efímero",
  "source_language": "en",
  "target_language": "es",
  "confidence": 0.97
}

👤 Users & Collections

v1

POST /api/v1/collections Create a new word collection for a user ▾

Name	Type	Required	Description
`name`	string	Required	Collection name
`description`	string	Optional	Optional description

{
  "name": "Advanced Vocabulary",
  "description": "Words for GRE prep"
}

{
  "id": "col_8f9a2b3c",
  "name": "Advanced Vocabulary",
  "word_count": 0,
  "created_at": "2025-06-15T10:30:00Z"
}

DELETE /api/v1/collections/{id} Permanently delete a user collection ▾

Name	Type	Required	Description
`id`	string	Required	Collection identifier

DELETE /api/v1/collections/col_8f9a2b3c
Host: api.dictionary.com
Authorization: Bearer <YOUR_API_KEY>

{
  "success": true,
  "message": "Collection deleted successfully"
}