Wordle Answers API

We maintain a complete, consistently formatted historical dataset of all official Wordle answers and provide open JSON access through this API. The goal is to offer developers, researchers, and educators a dependable source of Wordle data for applications, analytics, visualization projects, and automated tools. This dataset updates daily and includes puzzle dates, numbers, solutions, and difficulty ratings for seamless integration.

Below, you’ll find full endpoint documentation, example queries, and details on how to retrieve current or historical data. The API is free for non-abusive use, and attribution is appreciated where appropriate.

Base URL

All requests are made via HTTPS using simple GET requests. No authorization required.

https://wordlehints.co.uk/wp-json/wordlehint/v1/

Two main endpoints are available:

  • /answers – list of past answers (with filters & pagination)
  • /answers/latest – the latest available Wordle answer

Endpoint: List of Past Answers

URL:

GET https://wordlehints.co.uk/wp-json/wordlehint/v1/answers

Description: Returns historical Wordle answers from our database, with optional filters and pagination.

Query Parameters

  • game (integer, optional)
    Filter by NYT Wordle game number.
    Example: ?game=1624
  • date (string, optional)
    Filter by exact date in YYYY-MM-DD format.
    Example: ?date=2025-11-28
  • from (string, optional)
    Start date (inclusive) for a date range in YYYY-MM-DD format.
    Example: ?from=2025-11-01
  • to (string, optional)
    End date (inclusive) for a date range in YYYY-MM-DD format.
    Example: ?to=2025-11-30
  • answer (string, optional)
    Filter by the answer word. Case-insensitive; only letters A–Z are used, max length 10.
    Example: ?answer=gruff
  • order (string, optional)
    Sort order by date: asc or desc. Default is desc (newest first).
    Example: ?order=asc
  • page (integer, optional)
    Page number for pagination (1-based). Default is 1.
    Example: ?page=2
  • per_page (integer, optional)
    Number of results per page. Default is 50, maximum is 200.
    Example: ?per_page=100

Example Requests

1. Get the latest 50 answers (default):

GET https://wordlehints.co.uk/wp-json/wordlehint/v1/answers

2. Get answers for November 2025:

GET https://wordlehints.co.uk/wp-json/wordlehint/v1/answers?from=2025-11-01&to=2025-11-30

3. Get the record for game #1624:

GET https://wordlehints.co.uk/wp-json/wordlehint/v1/answers?game=1624

4. Find when “CRANE” appeared:

GET https://wordlehints.co.uk/wp-json/wordlehint/v1/answers?answer=crane

Response Format

The /answers endpoint returns a wrapper object with metadata and a results array:

{
  "source": "wordlehints.co.uk",
  "version": "1.0",
  "count": 50,
  "total": 1610,
  "page": 1,
  "per_page": 50,
  "has_more": true,
  "results": [
    {
      "game": 1624,
      "date": "2025-11-28",
      "day_name": "Friday",
      "answer": "GRUFF",
      "difficulty": 4.6
    },
    {
      "game": 1623,
      "date": "2025-11-27",
      "day_name": "Thursday",
      "answer": "MUGGY",
      "difficulty": 4.3
    }
  ]
}

Field meanings:

  • game – NYT Wordle puzzle number.
  • date – Puzzle date in YYYY-MM-DD.
  • day_name – Day of the week (e.g. Friday).
  • answer – The solution word for that day.
  • difficulty – A 1-decimal difficulty score (e.g. 3.64.85.0). This is based on NYT’s internal testers’ ratings and may be updated over time.

Endpoint: Latest Wordle Answer

URL:

GET https://wordlehints.co.uk/wp-json/wordlehint/v1/answers/latest

Description: Returns the most recent Wordle answer in a single JSON object.

Example Response

{
  "game": 1624,
  "date": "2025-11-28",
  "day_name": "Friday",
  "answer": "GRUFF",
  "difficulty": 4.6
}

This endpoint is ideal for apps or widgets that only need today’s Wordle answer.

Code Examples

cURL

# Latest answer
curl https://wordlehints.co.uk/wp-json/wordlehint/v1/answers/latest

# All answers for November 2025
curl "https://wordlehints.co.uk/wp-json/wordlehint/v1/answers?from=2025-11-01&to=2025-11-30"

JavaScript (Fetch)

fetch('https://wordlehints.co.uk/wp-json/wordlehint/v1/answers/latest')
  .then(response => response.json())
  .then(data => {
    console.log('Latest Wordle:', data.answer, 'Game #', data.game);
  })
  .catch(err => console.error(err));

Python (requests)

import requests

url = "https://wordlehints.co.uk/wp-json/wordlehint/v1/answers"
params = {"from": "2025-11-01", "to": "2025-11-30"}

resp = requests.get(url, params=params, timeout=10)
resp.raise_for_status()
data = resp.json()

for item in data.get("results", []):
    print(item["date"], item["game"], item["answer"], item["difficulty"])

Usage Guidelines

Please cache responses in your app or script rather than requesting the same data repeatedly. Wordle answers don’t change often.

If you use this API in a public project, a small credit or link to WordleHints.co.uk is appreciated.

The API is free and public, but abusive or automated scraping may be blocked.

For feature requests, post your comment below or contact us.

If you build something cool with this API, feel free to contact us via the site and let us know.

Spread the love

Join the discussion

This site uses Akismet to reduce spam. Learn how your comment data is processed.