API Docs

Get a random joke

Sample Api Call

GET https://api.irkfdb.in/facts/random

Sample Response Format

{
    "joke":{
        "id":"01gxka07g2me847pe6k0zp27jf",
        "text":"The only time Rajini needed a body double was crying scene !",
        "link":"http:\/\/api.irkfdb.in.test\/facts\/01gxka07g2me847pe6k0zp27jf",
        "categories":[]
    }
}

Get a specific joke

Sample Api Call

GET https://api.irkfdb.in/facts/01gxka07g2me847pe6k0zp27jf

Sample Response Format

{
    "joke":{
        "id":"01gxnfm87vdv7xh2mehm3bj787",
        "text":"Rajinikanth can make onions cry.",
        "link":"http:\/\/api.irkfdb.in.test\/facts\/01gxnfm87vdv7xh2mehm3bj787",
        "categories":[]
    }
}

Get a random joke from a specific category/categories

You can pass the single category or multiple categories as comma separated values in categories query parameter.

Sample Api Call

GET https://api.irkfdb.in/facts/random?categories=dev

Sample Response Format

{
    "joke":{
        "id":"01gxn98qby452h66xrchsrzaht",
        "text":"Once Rajinikanth bite an apple and threw it away, not its is known as Apple computers logo","link":"http:\/\/api.irkfdb.in.test\/facts\/01gxn98qby452h66xrchsrzaht",
        "categories":[
            {
                "id":"01gwmn4pfb33kfzrxkp2ey86x7",
                "title":"dev"
            }
        ]
    }
}

Get a random joke by excluding specific category/categories

You can pass the single category or multiple categories as comma separated values in not_categories query parameter.

Sample Api Call

GET https://api.irkfdb.in/facts/random?not_categories=explicit

Sample Response Format

{
    "joke":{
        "id":"01gxn98qby452h66xrchsrzaht",
        "text":"Once Rajinikanth bite an apple and threw it away, not its is known as Apple computers logo","link":"http:\/\/api.irkfdb.in.test\/facts\/01gxn98qby452h66xrchsrzaht",
        "categories":[
            {
                "id":"01gwmn4pfb33kfzrxkp2ey86x7",
                "title":"dev"
            }
        ]
    }
}