Shobdo Logo

Changelog

A chronological record of changes to the Shobdo API. We follow semantic versioning for the API. Breaking changes will always result in a new API version.


v1.1.0 — July 2026

Major feature update expanding dictionary capabilities and introducing GraphQL.

Endpoints
  • GET /api/v1/api/autocomplete — High-performance edge-cached typeahead suggestions.
  • GET /api/v1/api/examples — Search across millions of dictionary usage sentences and literary citations.
  • GET /api/v1/api/thesaurus/{word} — Retrieve synonyms, antonyms, and related words.
  • GET /api/v1/api/random — Fetch a random word from the dictionary (edge cached).
  • POST /api/v1/api/graphql — Brand new GraphQL endpoint for flexible and efficient queries.
  • GET /api/v1/api/me/usage — Check your current API quota and monthly usage programmatically.
Features
  • Advanced Filtering: Added pos (Part of Speech) and hasAudio filters to the /search endpoint.
  • GraphQL Support: Full schema covering search, entry lookup, thesaurus, and random endpoints.

v1.0.0 — July 2026

Initial public release of the Shobdo API.

Endpoints
  • GET /api/v1/api/search — Full-text search across 30+ dictionaries with language and dictionary filtering, configurable match types (exact, prefix, contains), and pagination.
  • GET /api/v1/api/entry/{source}/{id} — Retrieve full dictionary entries by ID, including definitions, examples, etymology, phrases, and audio URLs.
  • GET /api/v1/api/entry/{source}/word/{word} — Look up entries by word string with full Unicode support.
  • GET /api/v1/api/audio/{source}/{lexid} — Stream pronunciation audio via CDN redirect.
Features
  • Bearer token authentication with API key management via Console.
  • Monthly rate limiting with tiered plans (Free, Developer, Professional, Pay-As-You-Go).
  • Support for 18 languages: English, German, French, Spanish, Italian, Portuguese, Russian, Chinese, Japanese, Hindi, Urdu, Bengali, Arabic, Persian, Burmese, Bulgarian, Greek, and Thai.
  • Consistent JSON response envelope across all endpoints.
  • Global CDN-backed audio delivery.

Assistant

Hi! I'm the Shobdo Assistant.
Ask me anything about the documentation.