Dictionary API

Free · Livelanguage

Every word in the English language: existence checks, autocomplete, random words, and (as scraped) full definitions.

https://api.gargantuan.dev/v1/dictionaryFull reference →

Quick start

No key needed. Try a request right now:

Request
curl "https://api.gargantuan.dev/v1/dictionary/languages"

Or open it in your browser: https://api.gargantuan.dev/v1/dictionary/languages

Authentication & limits

No key required. Anonymous callers are rate-limited by IP. Send Authorization: Bearer <key> (or an X-Api-Key header) for a higher tier.

With a key (higher tier)
curl "https://api.gargantuan.dev/v1/dictionary/languages" \
  -H "Authorization: Bearer YOUR_API_KEY"

Also accepts X-Api-Key or ?api_key=. Limits ride in X-RateLimit-* headers; over the limit returns 429. See rate limits.

Datasets

Pick one with ?lang= (or the relevant param). 1 available:

DatasetCodeLocaleEntries
Englishenen274,937

Endpoints

Edit the inputs and hit Send request to try any endpoint live, right here. No key needed.

GET/v1/dictionary/languages

List the supported languages (datasets).

Request
https://api.gargantuan.dev/v1/dictionary/languages
GET/v1/dictionary/random

Return a random word.

Request
https://api.gargantuan.dev/v1/dictionary/random?lang=en
GET/v1/dictionary/search

Autocomplete: words that start with a prefix.

Request
https://api.gargantuan.dev/v1/dictionary/search?q=ser&limit=5&lang=en
GET/v1/dictionary/{word}

Look up a word: whether it exists, its length, and any definition.

Request
https://api.gargantuan.dev/v1/dictionary/serendipity?lang=en

FAQ

Is the Dictionary API free to use?

Yes. It is free and public. Anonymous requests need no key and are rate-limited by IP; a free API key raises your limits.

Do I need an API key?

No key is required to start. Send an Authorization: Bearer key (or an X-Api-Key header, or ?api_key=) to move to a higher tier.

What is the base URL?

https://api.gargantuan.dev/v1/dictionary

What are the rate limits?

Every response carries X-RateLimit-Limit and X-RateLimit-Remaining headers. Anonymous callers get the lowest tier (by IP); a free key is higher; Pro is highest. Over the limit returns 429 with Retry-After.

What format does it return?

JSON over HTTPS. Every response also includes a "source": "itsmattgeorge.com" attribution field.

About the Dictionary API

The Dictionary API answers the lexical questions a program most often needs to ask about English: does this string exist as a word, which words start with a given prefix, give me a random word, and what does a word mean. Those four jobs sit at the heart of spell checking, word games, writing tools, and search boxes, and each has a long lineage in lexicography and computational linguistics.

An existence check is a membership test against a curated list of valid English headwords, the entries a lexicographer prints in bold at the top of a definition. The list is held in memory so a lookup is close to instant, which is what makes the endpoint practical for validating user input, cleaning word lists, or scoring a move in a word game.

Prefix autocomplete uses the classic data structure for the task, the trie or prefix tree, which stores words by shared prefixes so every completion for auto can be gathered without scanning the whole dictionary. The same idea powers the autocomplete suggestions in search engines and code editors.

Full definitions are compiled from openly available English lexical data and returned with part of speech, so the API can back a glossary, a tooltip, or a reading aid, while the random word endpoint draws uniformly from the same headword list for prompts, exercises, and games. For machine readable lexical structure beyond plain definitions, the research standard is Princeton University's WordNet, a lexical database that groups words into sets of synonyms.

Sources (6)
  1. Dictionary (Wikipedia)
  2. Lexicography (Wikipedia)
  3. Headword (Wikipedia)
  4. Trie, the prefix-tree data structure (Wikipedia)
  5. Autocomplete (Wikipedia)
  6. WordNet, Princeton University
Full reference & authentication
Params, live responses, keys, and every endpoint in one place.
Open the docs →