Random Words API

🦄 Get Random Words (with pronunciation) for Free using this API

🌍 Languages

English
Dutch
Spanish
French
Chinese
Japanese

🚀 API

English Random Words - https://random-words-api.vercel.app/word
Dutch Random Words - https://random-words-api.vercel.app/word/dutch
Spanish Random Words - https://random-words-api.vercel.app/word/spanish
French Random Words - https://random-words-api.vercel.app/word/french
Chinese Random Words - https://random-words-api.vercel.app/word/chinese
Japanese Random Words - https://random-words-api.vercel.app/word/japanese
Turkish Random Words - https://random-words-api.vercel.app/word/turkish
PWA Demo - Check Here

🎛 Route Options (English Only)

Base URL: https://random-words-api.vercel.app/word/english

- /noun
- /sentence
- /question
- /adjective
- /idiom
- /verb
- /letter
- /paragraph
- /vocabulary
- /1-word-quotes
- /2-word-quotes
- /3-word-quotes
- /affirmation

🌐 Sample API Response

API: https://random-words-api.vercel.app/word/
Method: GET

[
  {
    "word": "Exactor",
    "definition": "One who exacts; extortioner; claimer of rights  ",
    "pronunciation": "Eksaktor"
  }
]

🌐 Sample Dutch Response

API: https://random-words-api.vercel.app/word/dutch
Method: GET

[
  {
    "word": "Perfect",
    "definition": "Perfect",
    "pronunciation": "Perfekt"
  }
]

Check api.rest file for more details

💡 Learn New word

✨ Installation (Development)

# Clone the Repo
git clone https://github.com/mcnaveen/random-words-api random-words-api

# Cd into Directory
cd random-words

# Install Dependencies
npm install

# Start the Development Server
npm run dev

🔀 Deploying to Heroku

OneClick Deploy on Heroku

🔀 Deploying to Vercel

OneClick Deploy on Vercel

- Fork the Repo - Login to Vercel (https://vercel.com/dashboard) - Click Import
Project - Give Forked Repo URL - Go Live

🔐 Rate Limit

To configure the rate limit, edit the utils/index.js file
Look for limiter variable
max is the maximum number of requests allowed in a given time window
windowMs is the time window in milliseconds
message is the message to be returned when the rate limit is exceeded

😇 Add New Language

Create a new folder in data with the full language name ex: english
Add the words in the words.json file
It should be an array of objects with id, word, and definition properties
The id should be a unique number for each word
The word should be the word in the language
The definition should be the definition of the word in English
The pronunciation should be the pronunciation of the word in the language (Optional)

❓ How to Contribute?

Make your changes and follow the below instructions. We follow conventional commits.

✍️ Commit

Stage all changes

git add .

Commit the changes

yarn commit

Push the changes to GitHub

git push <TO YOUR FORK>

⚛ USED BY

Project Name	Demo/Preview	Source Code	Author
Vue Random Words	Demo	Source	@mskian
Speak & Spell Elm	Demo	Source	@gacallea
Random Words CLI	Showcase	Source	@mcnaveen
Random Words CLI (Deno)	Showcase	Source	@mskian