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.

Endpoints

• /query?date={date} - Gets the WOTD for a specific date (format: DD-MM-YYYY). 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.

Request:

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

Response:

{
    "date": "01-01-2025",
    "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).

Request:

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

Response:

{
    "has_more": true,
    "results": [
        {
            "date": "16-01-2025",
            "word": "octothorpe",
            "pos": "Noun",
            "ipa": "/ˈɒktəʊθɔːp/",
            "definition": "(chiefly US, typography) The hash or square symbol #, used mainly in telephony and computing."
        },
        {
            "date": "15-01-2025",
            "word": "loquacious",
            "pos": "Adjective",
            "ipa": "/ləʊˈkweɪʃəs/",
            "definition": "Talkative; chatty."
        },
        {
            "date": "14-01-2025",
            "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.

Request:

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

Response:

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

Contact

If you have questions or need further assistance, please contact us at [email protected]. More information can be found on our contact page.

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.
• 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 :)