Random Generation API

Github
A side profile of a man wearing glasses and a yellow beanie. He has a beard and is looking upwards. The background is a vibrant blue. The man's attire includes a greenish-gray shirt. The art style is modern, with a mix of sharp and soft edges, and the use of various shades of color to depict depth and texture.
Click here to see my website

This is a simple, public API to generate random words or numbers. It is free for use, and available open source if you'd like to host it yourself.

It's provided as a free service to help people who need a random value in a script or a quick small project. While I do my best to keep it running, there are no guarantees of uptime or support. There are rate limits in place to prevent abuse.

If you need higher rate limits or uptime guarantees, contact me at rnd@bgenc.dev to discuss options.

Kaan Barmore-Genc

Integer

Returns a random integer, a subset of whole numbers.

GET

Output

The limits are inclusive of min, but exclusive of max. So for example, with min set to 0 and max set to 10, the output will be between 0 and 9.
If no min is specified, the default is 0. If no max is specified, the default is 100. You may use negative numbers for min and max. min must be strictly less than max.
These limits are also bound by minimum and maximum values of go's int type. This practically means 32-bit integers.
Floating-Point Number
Returns a random floating-point number, a subset of real numbers.
GET
Output
Returns a floating point number, a subset of real numbers.
If no min is specified, the default is 0. If no max is specified, the default is 1. You may use negative numbers for min and max. min must be strictly less than max.
Dice
Rolls dice in a variety of formats, like 2d8.
GET
Output
Generates a random number following an RPG dice format. Use the input parameter to specify what dice you are trying to roll. If not specified, the default is 1d6.
  • Standard: xdy[[k|d][h|l]z][+/-c] rolls and sums x y-sided dice, keeping or dropping the lowest or highest z dice and optionally adding or subtracting c. Example: 4d6kh3+4 means roll 4 six-sided dice, keep the highest 3, and add 4.
  • Fudge: xdf[+/-c] rolls and sums x fudge dice (Dice that returns numbers between -1 and 1), and optionally adding or subtracting c. Example: 4df+4
  • Versus: xdy[e|r]vt rolls x y-sided dice, counting the number that roll t or greater.
  • EotE: xc [xc ...] rolls x dice of color c (b, blk, g, p, r, w, y) and returns the aggregate result.
  • Adding an e to the versus rolls above makes dice explode. Dice are rerolled and have the rolled value added to their total when they roll a y. Adding an r makes dice rolling a y add another die to the pool instead.
Use the output parameter to specify what you want to get back. If not specified, the default is sum, which adds up the totals of all the dice rolled. If you specify full, you will get back not just the sum but a list of individual rolls, including discarded ones if there are any.
ULID
GET
Output
Generate a Universally Unique Lexicographically Sortable Identifier, a more compact and sortable alternative to UUID. There are no parameters, the output is always a 26 character string.
UUID
GET
Output
Generate a Universally Unique Identifier. Only versions 4 and 7 are supported. 4 is completely random, while 7 starts with a timestamp that allows it to be sortable by time. If not specified, the default version is 4.
Nano ID
GET
Output
An even more compact random identifier than ULID, with a customizable size. The default size is 21 characters, and it must always be 1 or higher. Differently from ULID, the nanoids are not sortable.
Word
Generate one or more random words, from a variety of categories.
GET
Output
Use category to pick what type of word you want.
  • words: The default category. This is a list of over 9000 common English words, all at least 3 letters long. There should be no swear words in this list. There are proper nouns in this list.
  • animals: Almost 300 animal names in English.
  • cities: A list of over 2500 city names from around the world. This list comes from United Nations list of cities with 100,000 or more inhabitants. Out of that list, all city names that contain spaces or symbols were removed.
  • countries: A list of 195 countries. This list may include some "controversial" countries that are not universally recognized, such as Taiwan, and omits others like Northern Cyprus. Some of these countries have spaces in their names, in which case they still count as one word despite the space.
  • fruits: A list of around 50 fruits, only including fruits that have single word names that I recognize. This list is not exhaustive by any means. It only includes fruits by the culinary definition, ones like tomatoes are not included despite their botanical classification.
  • vegetables: A list of around 50 vegetables, only including vegetables that have single word names that I recognize. This list is not exhaustive by any means. It only includes vegetables by the culinary definition, ones like cucumbers are not included despite their botanical classification.
  • lorem-ipsum: Around 140 words that are commonly used in "lorem ipsum" placeholder text.
  • nouns A list of 1000 most common English nouns. Includes abbreviations like TV, but no proper nouns.
The count parameter specifies how many words you want. This must be 1 or higher. The default is 1. If the count is set to higher than 1, the words will be separated by the separator, a space by default.