API Documentation

Welcome to the Word of the Day API documentation. This API provides access to the daily word, its definition, and usage examples. The base URL for all API requests is https://api.wotd.site, you may use the API for free, but please note that it is rate-limited to 10 requests per minute. The API cannot be used to request future WOTDs.

Endpoints

  • /query?date={date} - Gets the WOTD for a specific date (format: YYYY-MM-DD). If no date is provided, it defaults to the current date.
  • /query_previous?date={date}&limit={limit} - Gets a list of previous WOTDs. The date parameter is optional and defaults to the current date. The limit parameter specifies how many previous WOTDs to return (default is 3, maximum is 8).
  • /find_wotd?word={word} - Searches for a specific word in the WOTD database. The word parameter is required.

/query?date={date}

Retrieves the Word of the Day for a specific date. If no date is provided, it defaults to the current date.

Example request:

GET /query?date=2025-01-01 HTTP/1.1
Host: api.wotd.site
Accept: application/json

Example response:

{
  "date": "2025-01-01",
  "word": "sesquipedalian",
  "pos": "Noun",
  "ipa": "/ˈsɛs.kwɪ.pɪˈdeɪ.lɪ.ən/",
  "definition": "A person who uses long words."
}

/query_previous?date={date}&limit={limit}

Retrieves a list of previous Words of the Day. The date parameter is optional and defaults to the current date. The limit parameter specifies how many previous WOTDs to return (default is 3, maximum is 8).

Example request:

GET /query_previous?date=2025-01-17&limit=3 HTTP/1.1
Host: api.wotd.site
Accept: application/json

Example response:

{
  "has_more": true, 
  "results": [
    {
      "date": "2025-01-16",
      "word": "octothorpe",
      "pos": "Noun",
      "ipa": "/ˈɒktəʊθɔːp/",
      "definition": "(chiefly US, typography) The hash or square symbol #, used mainly in telephony and computing."
    },
    {
      "date": "2025-01-15",
      "word": "loquacious",
      "pos": "Adjective",
      "ipa": "/ləʊˈkweɪʃəs/",
      "definition": "Talkative; chatty."
    },
    {
      "date": "2025-01-14",
      "word": "melancholy",
      "pos": "Noun",
      "ipa": "/ˈmɛlənˌkəlɪ/",
      "definition": "(historical) Black bile, formerly thought to be one of the four \"cardinal humours\" of animal bodies."
    }
  ]
}

/find_wotd?word={word}

Searches for a specific word in the Word of the Day database. The word parameter is required.

Example request:

GET /find_wotd?word=sesquipedalian HTTP/1.1
Host: api.wotd.site
Accept: application/json

Example response:

[
  {
    "date": "2035-01-01",
    "word": "sesquipedalian",
    "pos": "Adjective",
    "ipa": "/ˈsɛs.kwɪ.pɪˈdeɪ.lɪ.ən/",
    "definition": "(of a word or words) Long; polysyllabic."
  },
  {
    "date": "2025-01-01",
    "word": "sesquipedalian",
    "pos": "Noun",
    "ipa": "/ˈsɛs.kwɪ.pɪˈdeɪ.lɪ.ən/",
    "definition": "A person who uses long words."
  }
]

Contact Info

If you have questions or need further assistance, please contact us at [email protected].

Usage Guidelines

Please adhere to the following guidelines when using the Word of the Day API:

  • Attribution: Please give attribution to WOTD when using the API in your applications or services.
  • Rate Limiting: The API is rate-limited to 10 requests per minute. Exceeding this limit will result in temporary access restrictions.
  • Data Scraping: Do not scrape our data excessively. If you need to download a full copy of the WOTD database, you can do so here.
  • Commercial Use: Don't charge money for the Word of the Day, our service should remain free for all users.

Thank you for using the WOTD API :)