Dictionary API documentation

Use the Discussion Dictionary API to search approved entries, definitions, pronunciation fields and learner metadata.

Search endpoint

Returns approved public dictionary entries matching a headword prefix.

GET https://dictionary.discussionpublishers.com/api/public/dictionary/search?q=book&limit=10
Authorization: Bearer dd_live_your_private_key

Example response

{
  "query": "book",
  "results": [
    {
      "headword": "book",
      "slug": "book-en",
      "part_of_speech": "noun",
      "pronunciation_ipa": "bʊk",
      "definitions": ["a written or printed work consisting of pages"]
    }
  ]
}

Authentication

Send the key in the Authorization header as a bearer token. Never publish it in browser JavaScript.

Data scope

The API returns approved public dictionary data only: headwords, slugs, definitions, examples and pronunciation metadata.

Indexing

Public docs and dictionary pages are listed in the sitemap so search engines can discover the API documentation and entries.