{"openapi":"3.1.0","info":{"title":"Words API","version":"1.0.0","description":"Find words by meaning, sound and spelling — similar-meaning words (thesaurus), rhymes, autocomplete suggestions and wildcard spelling matches. Backed by Datamuse. Ideal for writing assistants, autocomplete, crosswords, word games, poetry tools and NLP preprocessing.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/words-api","description":"oanor gateway"}],"tags":[{"name":"Words"}],"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/rhymes":{"get":{"operationId":"get_v1_rhymes","tags":["Words"],"summary":"Rhyming words","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"Source word","schema":{"type":"string"},"example":"blue"},{"name":"max","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"rhymes","word":"blue","count":20,"results":[{"word":"slew","score":41039},{"word":"subdue","score":31034},{"word":"pursue","score":28033},{"word":"true","score":27050},{"word":"view","score":27048},{"word":"construe","score":27039},{"word":"hitherto","score":27030},{"word":"eschew","score":26039},{"word":"purview","score":25041},{"word":"imbue","score":25036},{"word":"coo","score":24050},{"word":"taboo","score":24043},{"word":"rendezvous","score":23044},{"word":"skew","score":19044},{"word":"through","score":19042},{"word":"guru","score":17042},{"word":"overview","score":17034},{"word":"retinue","score":16033},{"word":"new","score":15054},{"word":"review","score":15050}]},"meta":{"timestamp":"2026-05-30T04:59:07.013Z","request_id":"18f21e1f-6d9e-4287-bb96-6296598634f4"},"status":"ok","message":"Rhymes retrieved","success":true}}}},"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/similar":{"get":{"operationId":"get_v1_similar","tags":["Words"],"summary":"Similar-meaning words","description":"","parameters":[{"name":"word","in":"query","required":true,"description":"Source word","schema":{"type":"string"},"example":"ocean"},{"name":"max","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"similar_meaning","word":"ocean","count":20,"results":[{"tags":["syn","n","results_type:primary_rel"],"word":"sea","score":40041792},{"tags":["n"],"word":"expanse","score":30041645},{"tags":["adj","n","prop"],"word":"oceanic","score":30041524},{"tags":["n"],"word":"seabed","score":30040935},{"tags":["n"],"word":"seafloor","score":30040708},{"tags":["adj","prop"],"word":"oceanographic","score":30040704},{"tags":["n"],"word":"pelagic","score":30040597},{"tags":["n"],"word":"oceanography","score":30040196},{"tags":["n"],"word":"marine","score":30039769},{"tags":["n"],"word":"midstream","score":30039492},{"tags":["n"],"word":"coast","score":30039440},{"tags":["n"],"word":"pond","score":30039027},{"tags":["n"],"word":"water","score":30035370},{"tags":["n"],"word":"seawater","score":30029515},{"tags":["n"],"word":"waters","score":30015259},{"tags":["n"],"word":"seaway","score":30012345},{"tags":["n"],"word":"bucket","score":30012024},{"tags":["n"],"word":"marina","score":30011807},{"tags":["adj"],"word":"seagoing","score":30008217},{"tags":["n"],"word":"seafaring","score":30008164}]},"meta":{"timestamp":"2026-05-30T04:59:07.628Z","request_id":"ae730fa2-2e61-49a8-bd4c-c746b0c36f02"},"status":"ok","message":"Similar words retrieved","success":true}}}},"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/spelled":{"get":{"operationId":"get_v1_spelled","tags":["Words"],"summary":"Wildcard spelling match","description":"","parameters":[{"name":"pattern","in":"query","required":true,"description":"Pattern with ? and *","schema":{"type":"string"},"example":"t??k"},{"name":"max","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"pattern":"t??k","results":[{"word":"task","score":22048},{"word":"trek","score":17036},{"word":"tack","score":14063},{"word":"tank","score":9061},{"word":"tusk","score":8036},{"word":"tuck","score":6046},{"word":"took","score":6035},{"word":"tick","score":5078},{"word":"tonk","score":5016},{"word":"talk","score":4048},{"word":"tink","score":3021},{"word":"thnk","score":2002},{"word":"turk","score":1033},{"word":"teek","score":1012},{"word":"truk","score":1009},{"word":"tock","score":1009},{"word":"trak","score":1006},{"word":"tisk","score":1006},{"word":"tork","score":1004},{"word":"tsik","score":1002}]},"meta":{"timestamp":"2026-05-30T04:59:08.067Z","request_id":"85ee569e-4332-4f5b-a5d8-818cbef8d720"},"status":"ok","message":"Matches retrieved","success":true}}}},"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/suggest":{"get":{"operationId":"get_v1_suggest","tags":["Words"],"summary":"Autocomplete suggestions","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Prefix","schema":{"type":"string"},"example":"eleph"},{"name":"max","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"q":"eleph","count":10,"results":[{"word":"elephantine","score":152071},{"word":"elephanticide","score":149037},{"word":"elephant trunk","score":146039},{"word":"elephant","score":145087},{"word":"elephan","score":145038},{"word":"elephantiasis","score":144076},{"word":"elephants","score":144059},{"word":"elephants foot","score":144055},{"word":"elephant seal","score":144054},{"word":"elephant ear","score":144053}]},"meta":{"timestamp":"2026-05-30T04:59:08.599Z","request_id":"7c5e084e-3aae-4676-bde3-1bee3efc05f6"},"status":"ok","message":"Suggestions retrieved","success":true}}}},"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":12000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":120000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":600000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6400,"monthly_call_quota":2500000,"rps_limit":80,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/words-api"}