Wordle Helper API

Overview

To use Wordle Helper, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/wordlehelper

Example

How to call the Wordle Helper API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/wordlehelper?green=A1%2CE5&yellow=R2%2CO3&gray=STLN&pattern=A___E&limit=25" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/wordlehelper?green=A1%2CE5&yellow=R2%2CO3&gray=STLN&pattern=A___E&limit=25', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/wordlehelper?green=A1%2CE5&yellow=R2%2CO3&gray=STLN&pattern=A___E&limit=25', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/wordlehelper?green=A1%2CE5&yellow=R2%2CO3&gray=STLN&pattern=A___E&limit=25", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "matchCount": 11,
    "suggestions": [
      "adore",
      "afore",
      "afire",
      "argue",
      "aerie",
      "azure",
      "aurae",
      "arame",
      "agree",
      "aware",
      "areae"
    ],
    "filters": {
      "green": {
        "0": "a",
        "4": "e"
      },
      "yellow": [
        "r"
      ],
      "gray": [
        "s",
        "t",
        "l",
        "n"
      ]
    },
    "pattern": "A___E"
  }
}

Authentication

The Wordle Helper API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Wordle Helper API directly in your browser with live requests and responses.

Parameters

The following parameters are available for the Wordle Helper API:

Response

The Wordle Helper API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <matchCount>11</matchCount>
    <suggestions>
      <suggestion>adore</suggestion>
      <suggestion>afore</suggestion>
      <suggestion>afire</suggestion>
      <suggestion>argue</suggestion>
      <suggestion>aerie</suggestion>
      <suggestion>azure</suggestion>
      <suggestion>aurae</suggestion>
      <suggestion>arame</suggestion>
      <suggestion>agree</suggestion>
      <suggestion>aware</suggestion>
      <suggestion>areae</suggestion>
    </suggestions>
    <filters>
      <green>
        <0>a</0>
        <4>e</4>
      </green>
      <yellow>
        <item>r</item>
      </yellow>
      <gray>
        <item>s</item>
        <item>t</item>
        <item>l</item>
        <item>n</item>
      </gray>
    </filters>
    <pattern>A___E</pattern>
  </data>
</response>

status: ok
error: null
data:
  matchCount: 11
  suggestions:
    - adore
    - afore
    - afire
    - argue
    - aerie
    - azure
    - aurae
    - arame
    - agree
    - aware
    - areae
  filters:
    green:
      '0': a
      '4': e
    yellow:
      - r
    gray:
      - s
      - t
      - l
      - 'n'
  pattern: A___E

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Wordle Helper through GraphQL to combine it with other API calls in a single request. Query only the wordle helper data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  wordlehelper(
    input: {
      green: "A1,E5"
      yellow: "R2,O3"
      gray: "STLN"
      pattern: "A___E"
      limit: 25
    }
  ) {
    matchCount
    suggestions
    filters {
      green {
        0
        4
      }
      yellow
      gray
    }
    pattern
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The Wordle Helper API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Wordle Helper requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Wordle Helper API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Wordle Helper

Official Wordle Helper packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Wordle Helper works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in Wordle Helper, you might also like these APIs:

Truth or Dare

Truth or Dare generates random truth questions and dare challenges for the classic party game. Features 400+ unique prompts with per-API-key tracking to avoid repeats.

1 credit per call

Trivia Generator

Trivia is a simple tool for getting trivia questions. It returns a random trivia question based on your selected category.

1 credit per call

Sudoku Generator

Sudoku is a simple tool for generating Sudoku puzzles. It returns a Sudoku puzzle.

2 credits per call