mcnaveen / random-words-api

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

Random Words API

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

🚀 API

• Free API - https://random-words-api.vercel.app/word

• Dutch Random Words - https://random-words-api.vercel.app/word/dutch

• Get Pronunciation for a Word - https://random-words-api.vercel.app/pronounce/

• PWA Demo - Check Here

🎛 Route Options

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

- /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"
  }
]

🌐 Sample Pronunciation Request

• API: https://random-words-api.vercel.app/pronounce
• Method: POST

POST http://localhost:3000/pronounce
Content-Type: application/json

{
  "word": "This is amazing"
}

📣 Sample Pronunciation Response

{
  "pronunciation": "this is amasink"
}

• Check api.rest file for more details

💡 Learn New word

• Join Telegram Channel
• Learn Online

✨ Installation (Development)

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

# Cd into Directory
cd random-words

# Install Dependencies
yarn install

# Start the Development Server
yarn start

🔀 Deploying to Heroku

OneClick Deploy on Heroku

🔀 Deploying to Vercel

OneClick Deploy on Vercel

OR

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

❓ 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

☑ License

• MIT

⚠ Disclaimer

We don't own any data or word. All belongs to the owner of Website. Use it for educational purpose only.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

MC Naveen 🐛 💻 🔣 📖 💡 🤔 🚧 👀

jonah-butler 💻 📖

Santhosh Veer 💻 📖 🤔 🚧 🐛 👀

This project follows the all-contributors specification. Contributions of any kind welcome!

random-words-api's Issues

Speak & Spell usage of the API :)

Hi @mcnaveen :)

I wanted to thank you for the API and let you know that I've used your API for my Elm learning project. Up to you if you want to include it in the README as example usage.

game: https://speak-and-spell.vercel.app/
code: https://github.com/gacallea/elm_speakandspell

Cheers!

Possible to make a dutch version

would it be possible to make a dutch version were it takes the info from https://www.generatormix.com/random-dutch-words-generator

and outputs the dutch instead of the word and the english instead of the meaning?

Action Required: Fix Renovate Configuration

There is an error with this repository's Renovate configuration that needs to be fixed. As a precaution, Renovate will stop PRs until it is resolved.

Location: renovate.json
Error type: The renovate configuration file contains some invalid settings
Message: Invalid configuration option: node

API is not working

Fetching the URL: https://random-words-api.vercel.app/word and I've been getting the following message:
"Something Went Wrong - Enter the Correct API URL"

Just wondering if there is a request limit or if it went down?

How to get definition of a word

Is there an api of searching a word difinition?

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• fix(deps): update dependency axios to v1.6.0 [security]
• fix(deps): update dependency express to v4.19.2 [security]
• chore(deps): update dependency nodemon to ^2.0.22
• chore(deps): update actions/checkout action to v3.6.0
• chore(deps): update actions/setup-node action to v3.8.2
• chore(deps): update dependency all-contributors-cli to ^6.26.1
• chore(deps): update actions/checkout action to v4
• chore(deps): update actions/setup-node action to v4
• chore(deps): update dependency nodemon to v3
• chore(deps): update github/codeql-action action to v3
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

github-actions

.github/workflows/buildtest.yml

• actions/checkout v3.0.2
• actions/setup-node v3.4.1

.github/workflows/codeql-analysis.yml

• actions/checkout v3
• github/codeql-action v2
• github/codeql-action v2
• github/codeql-action v2

npm

package.json

• axios ^1.1.3
• cheerio ^1.0.0-rc.12
• express ^4.18.2
• node-pronounce ^0.0.4
• random-array-item ^0.0.2
• random-useragent ^0.5.0
• all-contributors-cli ^6.20.0
• gacp ^3.0.3
• nodemon ^2.0.19

---

• Check this box to trigger a request for Renovate to run again on this repository

Hello, is it possible to limit the length of the word?

Hi, I'd like to know if there is a possibility to limit the length of a word

Something Went Wrong - Enter the Correct API URL

Dear Dev,

Firstly, thanks for your work on this API.

Since today, I have thie error when calling the API : "Something Went Wrong - Enter the Correct API URL". It occurs when I call from my javascript or Postman, and event in Firefox Browser directly. Everything was working fine prior today.

I hop you have any advice to fix the situation
Thank you by advance,
Regards

less of an an issue, more of a query

Is there a way for me to get a word of some specific length? Say, I pass "5" as an argument and I receive a 5 letter word.

Now, I could check for the length of the word in the response and re-call the API if the length of the word is not equal to the length I want, but that would slow down both, the process and the API, right?

Dutch API Endpoint returns error

Merging PR #67 Introduced a route conflict for Dutch API endpoint and returns "Something Went Wrong - Enter the Correct API URL"

Current route
https://random-words-api.vercel.app/word

Expected route
https://random-words-api.vercel.app/dutch

If you can work on this issue. Please do and send a PR.