Random Chunk API

A simple random picker for names, movies, TV shows, quotes, and numbers. A simple JSON object, user object, and array generator.

API Reference

Get Random JSON Object Generator

  POST /api/object

Sample Request Body

{
    "schema": {
        "name":{
            "type":"name"
        },
        "role":{
            "type":"randomSelector",
            "options":["user","admin","auditor"]
        },
        "company": {
            "type":"string"
        },
        "age": {
            "type":"number",
            "range":[18,25]
        },
        "scores": {
            "type":"array",
            "data_type":"number",
            "range":[0,100],
            "size":4
        },
        "createdOn":{
            "type":"datetime"
        },
        "description":{
            "type":"paragraph"
        },
        "verified":{"type":"boolean"}
    },
    "size":2
}

Sample Response

{
    "success": true,
    "data": {
        "name": "Aron Zane Danielson",
        "role": "admin",
        "company": "admonisher",
        "age": 23,
        "scores": [
            66,
            58,
            91,
            37
        ],
        "createdOn": "2160-04-23T18:30:00.000Z",
        "description": "Officia saliqua sunt....",
        "verified": true
    }
}

Get Random Name

  GET /api/name

Query Parameter	Type	Value	Description
type	string	maleName | femaleName	The type of name required
startingLetter	string	Any english alphabet character	Starting letter of the name
count	integer	An integer (Default=1)	The number of names required

Sample Response

{
    "success": true,
    "data": {
        "id": "x6322",
        "firstName": "Ximena",
        "middleName": "Sasha",
        "lastName": "Light"
    }
}

Get Random Date

  GET /api/date

Query Parameter	Type	Value	Description
start	string	Date string	Minimum date value in YYYY-MM-DD (Default=1900-01-01)
end	string	An positive integer	Maximum date value in YYYY-MM-DD (Default=3000-12-31)

Sample Response

{
    "success": true,
    "data": "2022-12-23T00:00:00.000Z"
}

Get Random Password Generation

  GET /api/password

Query Parameter	Type	Value	Description
length	integer	Any positive integer (Default=16)	Required password length

Sample Response

{
    "success": true,
    "data": "Scr.=cdh_M<?oH4M"
}

Get Random User Object

  GET /api/user

Query Parameter	Type	Value	Description
count	integer	Any positive integer (Default=1)	Required number of user objects

Sample Response

{
    "success": true,
    "data": {
        "name": {
            "firstName": "Zaria",
            "middleName": "Tabitha",
            "lastName": "Antonio"
        },
        "email": "Zaria.Tabitha.Antonio@example.com",
        "sex": "F",
        "age": 67,
        "password": "77,wGy@.?&--_I1n"
    }
}

Get Random Movie Picker

  GET /api/movie

Query Parameter	Type	Value	Description
count	integer	Any positive integer [1,1100] (Default=1)	Required number of movies

Sample Response

{
    "id": "0-62",
    "name": "Unforgiven",
    "year": "1992",
    "cert": "A",
    "runtime": "130 min",
    "genre": "Drama, Western",
    "rating": "8.2",
    "desc": "Retired Old West gunslinger William Munny reluctantly takes on one last job, with the help of his old partner Ned Logan and a young man, The \"Schofield Kid.\"",
    "director": "Clint Eastwood",
    "stars": "Clint Eastwood, Gene Hackman, Morgan Freeman, Richard Harris"
}

Get Random TV show Picker

  GET /api/tvshow

Query Parameter	Type	Value	Description
count	integer	Any positive integer [1,1000] (Default=1)	Required number of TV shows

Sample Response

{
    "id": "4-459",
    "name": "Drop the Dead Donkey",
    "year": "1990–1998",
    "cert": "",
    "runtime": "",
    "genre": "Comedy",
    "rating": "80R",
    "desc": "Political satire about television news company Globe Link and its team of workers such as anchors Henry and Sally, reporter Damien, editor Dave, execs George and Helen, assistant Joy and manager Gus Hedges.",
    "stars": "Neil Pearson, Jeff Rawle, David Swift, Stephen Tompkinson"
}

Get Random Word Picker

  GET /api/word

Query Parameter	Type	Value	Description
count	integer	Any positive integer (Default=1)	Required number of words
type	string	verb | noun | adjective	Required type of word

Sample Response

{
    "success": true,
    "message": null,
    "data": {
        "id": "u-24",
        "word": "unacclimated",
        "type": "adjective"
    }
}

Get Random Array Generator

  GET /api/array

Query Parameter	Type	Value	Description
data_type	string	number | string | mixed (Default=number)	Required type array elements
size	integer	Any positive integer (Default=10)	Size of the array

Sample Response

{
    "success": true,
    "data": [
        "Xmas",
        "vacillated",
        "ensorcelled",
        "nursing",
        "quacks"
    ]
}

Get Random Quote Picker

  GET /api/quote

Query Parameter	Type	Value	Description
category	string	life | truth | love | science
count	integer	Any positive integer (Default=1)	Size of the array

Sample Response

{
    "success": true,
    "data": {
        "id": "279",
        "by": "Oprah Winfrey",
        "quote": "“The more you praise and celebrate your life, the more there is in life to celebrate.”"
    }
}

Get Random Color Generator

  GET /api/color

Sample Response

{
    "success": true,
    "data": {
        "rgb": {
            "R": 7,
            "G": 39,
            "B": 153
        },
        "hex": "#72799"
    },
    "hsv": {
        "H": 0.6301369863013698,
        "S": 0.9542483660130718,
        "V": 0.6
    },
    "hsl": {
        "H": 0.5,
        "S": 0.9125,
        "L": 0.3137254901960784
    }
}