A simple, public API to generate random words or numbers. This service is free to use and available as open-source software. Do you need a random word or a UUID in a script? Can't pull in dependencies easily? Call this API to grab one quickly.
The API provides endpoints for generating:
- Random integers
- Random floating-point numbers
- Dice rolls with various formats
- ULIDs (Universally Unique Lexicographically Sortable Identifier)
- UUIDs (versions 4 and 7)
- Nano IDs
- Random words from various categories like animals or vegetables
The API is accessible at https://rnd.bgenc.dev. You can make requests to the various endpoints, each with its own set of optional parameters.
Example:
https://rnd.bgenc.dev/v1/int?min=1&max=100
For detailed information on each endpoint and its parameters, please refer to the API documentation.
There are rate limits in place to prevent abuse. If you need higher rate limits or uptime guarantees, please contact [email protected] to discuss options.
To run the project locally:
- Clone the repository
- Install dependencies (Go 1.22 or later and npm are required)
- Run the following commands:
npm install
npm run devThis will start both the UI and the backend. The UI will be available at localhost:5173. The backend will restart if there are any changes, and the frontend will hot reload.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).
Issue reports, and pull requests are always welcome! If you encounter any bugs, or if there are other generators you'd like to see here, let us know. If you'd like to contribute, reach out and we can help you get started.
All contributions require a Contributor License Agreement.
For inquiries, please contact [email protected]. Increased rate limits, uptime guarantees, and licensing options are available.
While we do our best to keep the service running, there are no guarantees of uptime or support. This service is provided as-is for small projects and scripts.