API Reference

Free, public APIs. No key required to start; a free key raises your limits. Base URL:

https://api.gargantuan.dev/v1

Authentication

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

curl "https://api.gargantuan.dev/v1/dictionary/serendipity" \
  -H "Authorization: Bearer YOUR_API_KEY"

You can also pass the key as X-Api-Key or ?api_key=.

Rate limits

Every response carries your current limits in headers.

Tier	How you are identified	Limit
Anonymous	by IP address	lowest
Free (signed up)	by API key	higher
Pro	by API key	highest

Response headers: X-RateLimit-Limit, X-RateLimit-Remaining. Over the limit returns 429 with Retry-After.

Dictionary API

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

Languages: en. Pass ?lang= to choose one.

GET/v1/dictionary/languages

List the supported languages (datasets).

Request

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

Response

{
  "default": "en",
  "count": 1,
  "languages": [
    {
      "lang": "en",
      "label": "English",
      "locale": "en",
      "words": 274937
    }
  ],
  "source": "itsmattgeorge.com"
}

GET/v1/dictionary/random

Return a random word.

Parameters

Name	In	Required	Description
`lang`	query	optional	language dataset; default 'en' (see /v1/dictionary/languages)

Request

curl "https://api.gargantuan.dev/v1/dictionary/random?lang=en"

Response

{
  "word": "chinovniks",
  "length": 10,
  "lang": "en",
  "source": "itsmattgeorge.com"
}

GET/v1/dictionary/search

Autocomplete: words that start with a prefix.

Parameters

Name	In	Required	Description
`q`	query	required	the prefix to match
`limit`	query	optional	max results (default 20, max 100)
`lang`	query	optional	language dataset; default 'en' (see /v1/dictionary/languages)

Request

curl "https://api.gargantuan.dev/v1/dictionary/search?q=ser&limit=5&lang=en"

Response

{
  "query": "ser",
  "count": 5,
  "results": [
    "ser",
    "sera",
    "serac",
    "seracs",
    "serafile"
  ],
  "lang": "en",
  "source": "itsmattgeorge.com"
}

GET/v1/dictionary/{word}

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

Parameters

Name	In	Required	Description
`word`	path	required
`lang`	query	optional	language dataset; default 'en' (see /v1/dictionary/languages)

Request

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

Response

{
  "word": "serendipity",
  "lang": "en",
  "exists": true,
  "length": 11,
  "has_definition": false,
  "definition": null,
  "source": "itsmattgeorge.com"
}

Every response includes "source": "itsmattgeorge.com".