Skip to content

RazorSh4rk/random-word-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

949c460 · Mar 2, 2025

History

66 Commits
Feb 2, 2025
Apr 11, 2022
Feb 24, 2025
Apr 11, 2022
Feb 5, 2025
May 9, 2020
Feb 24, 2025
Jul 19, 2021
Mar 5, 2020
May 11, 2023
Feb 4, 2022
Jan 9, 2020

Repository files navigation

Random word API

Endpoints

/all

Return all stored words. This will be a huge data dump and will take a long time to fetch and will probably slow down your application.

Example:
https://random-word-api.herokuapp.com/all

/word

Return one stored word randomly. Options can be further specified, see the parameters menu.

Example:
https://random-word-api.herokuapp.com/word

/languages

Return a list of stored language codes. Useful if you want a multilanguage app. See Github to find out how to add your own.

Example:
https://random-word-api.herokuapp.com/languages

Parameters

?number

Set number of requested words. If it exceeds the maximum stored amount, it will just return all of them.

Example:
https://random-word-api.herokuapp.com/word?number=10

?length

Set length of requested words. This will only return words that contain x amount of letters.

Example:
https://random-word-api.herokuapp.com/word?length=5

?lang

Set language of requested words. Go to Github to get more info on how to add your own language.

Currently supported languages:
https://random-word-api.herokuapp.com/languages
Example:
https://random-word-api.herokuapp.com/word?lang=es

Development

You will need scala and sbt

pacman -S scala sbt
sbt run