{"openapi":"3.1.0","info":{"title":"Wordle API","version":"1.0.0","description":"A complete toolkit for Wordle-style word games: score a guess against a hidden answer and get the exact green/yellow/grey feedback pattern (with correct duplicate-letter handling), validate any word against the official dictionary, solve a puzzle from the clues collected so far (returns the remaining consistent answers and a suggested next guess that best narrows them down), pull a random answer word, and fetch the deterministic daily word for any date with its puzzle number. Built on the official answer list (2,315 words) and the full set of ~13,000 accepted guesses. Every endpoint accepts input via the query string or the request body and returns lean JSON. Pure server-side compute (no third-party upstream), so responses are instant and always available. Ideal for word-game backends, solvers and assistants, bots and educational apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wordle-api","description":"oanor gateway"}],"tags":[{"name":"Wordle"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/daily":{"get":{"operationId":"get_v1_daily","tags":["Wordle"],"summary":"Deterministic daily word","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD (default today)","schema":{"type":"string"},"example":"2026-01-01"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Wordle"],"summary":"Dictionary sizes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Wordle"],"summary":"Random answer word","description":"","parameters":[{"name":"size","in":"query","required":false,"description":"1..20 (default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/score":{"get":{"operationId":"get_v1_score","tags":["Wordle"],"summary":"Score a guess against an answer","description":"","parameters":[{"name":"guess","in":"query","required":true,"description":"5-letter guess","schema":{"type":"string"},"example":"crane"},{"name":"answer","in":"query","required":true,"description":"5-letter answer","schema":{"type":"string"},"example":"crate"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/solve":{"get":{"operationId":"get_v1_solve","tags":["Wordle"],"summary":"Solve from clues","description":"","parameters":[{"name":"guesses","in":"query","required":true,"description":"word:pattern pairs (g/y/x), comma-separated","schema":{"type":"string"},"example":"crane:xxxgx,slate:ggxxx"},{"name":"limit","in":"query","required":false,"description":"Max candidates 1..500","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/validate":{"get":{"operationId":"get_v1_validate","tags":["Wordle"],"summary":"Validate a word","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"5-letter word","schema":{"type":"string"},"example":"aalii"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":16000,"rps_limit":4,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":450,"monthly_call_quota":130000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1300,"monthly_call_quota":1100000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3300,"monthly_call_quota":6000000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wordle-api"}