Repository navigation
Home
Definitions · Synonyms · Antonyms · Part of Speech — in one free API call.
|
|
|
Get a Key · Try It · Response Format · Errors
We suggest that you visit the website.
Step 1 — Get your free API key
Visit /client and fill in your name and email. Your key arrives in your inbox within seconds.
Your key looks like this:
oa_f360fb6fe00b1be5b109e925 characters · always starts with
oa_· one per email · always free.
Step 2 — Make your first request
GET /api/{your_key}/eng/{word}
curl https://yourhost/api/oa_f367fb6fe04b1be5b129e9/eng/eloquent{
"word": "eloquent",
"lang": "eng",
"results": [
{
"definition": "Having the power of expressing strong emotions or arguments in a fluent and convincing way.",
"pos": "adj",
"pos_name": "Adjective",
"synonyms": "fluent, expressive, articulate",
"antonyms": "inarticulate, silent"
}
],
"error": null
}A word can return multiple results if it has more than one meaning. Each result is a separate object in the
resultsarray.
Misspelled a word? The API detects it automatically and returns the closest match. The corrected spelling appears in the "word" field so you always know what was looked up.
graph TD
Start([API is called]) -->|No error| ValidateKey[Validates API Key]
Start -->|Error| LocalError[Local error]
ValidateKey -->|fail| InvalidKey(["Key: Error <br/> Invalid or missing API key. Get one at /client"])
ValidateKey -->|valid| ValidateLang[Validates Language]
ValidateLang -->|fail| InvalidLang(["Key: Error <br/> Invalid language"])
ValidateLang -->|success| DBCheck[Looks for word in database]
DBCheck -->|found| ReturnNormal(["Returns Normal JSON data"])
DBCheck -->|is not found| SpellCorrect[Spell correct]
SpellCorrect --> LookClose[Look for close matches]
LookClose -->|is found| ReturnCorrected(["Returns with corrected word <br/> Key: Error <br/> Corrected"])
LookClose -->|can't be found| Gemini[Goes to Gemini]
Gemini --> ReturnCorrected
%% Success Styles (Green)
linkStyle 0,3,5,6,9 stroke:#39FF14,stroke-width:2px;
%% Failure Styles (Red)
linkStyle 1,2,4 stroke:#FF3131,stroke-width:2px;
%% "Not Found" / Discovery Styles (Blue)
linkStyle 7,10,11 stroke:#00D4FF,stroke-width:2px;
GET /api/{key}/eng/{word}
This gives you the same json data as listed above.
| Status | Meaning | Fix |
|---|---|---|
401 |
Invalid API key | Copy your key exactly from the email |
500 |
Server error | Try again or contact us |
404 |
Page not found | Use the default redirect |
Something broken or a word missing? Open /client, scroll to the feedback form, leave a rating and a message. Email is optional but helps us follow up.
| Base URL | /api/{key}/eng/{word} |
| Language |
eng (English) |
| Key format |
oa_ + 22 hex chars = 25 total |
| Key cost | Free |
| Keys per email | 1 |
| Response format | JSON |
| Spell correction | Automatic |
Source-Available · Limited Use License Copyright © 2026 Aditya Raj and Pratyush Raj
This license governs use of the software and associated documentation files (the "Software") in this repository. The Software is provided for educational and personal review purposes only.
- Download and view the source code on your local machine
- Compile and run the Software for private, non-commercial, personal projects
No written permission from the copyright holder? Then the following are strictly prohibited:
- No Redistribution — You may not share, host, mirror, or redistribute the source code or compiled binaries in any form
- No Commercial Use — You may not use the Software for any commercial purpose, including selling it or using it within a commercial entity
- No Derivative Works — You may not modify the Software and distribute those modifications as a separate project
This license terminates automatically if you breach any of these terms. Upon termination, you must destroy all copies of the Software in your possession.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.
For permissions beyond the scope of this license, contact the copyright holder.