Riddle API

Generate random riddle for many many categories with a simple API Call.

API End Points

The end point for connecting : If you subscribe directly from us use this endpoint.

	https://api.fungenerators.com

Get a random riddle entry

GET /riddle/random

The above call should produce a result like the following

{
  "success": {
    "total": 1
  },
  "contents": {
    "id": "zw3zqHsuULWHKhMnDC7OfweF",
    "riddle": "I have 10 books and I label them with their number. I take seven out to read. How many books are left?",
    "answer": [
      "9! You have token the book with the label seven!"
    ],
    "title": null,
    "category": "",
    "subcategory": "",
  },
  "copyright": {
    "url": "https://api.fungenerators.com",
    "year": "2024"
  }
}

Search for a random riddle entry

GET /riddle/search?
              query=flower

The above call should produce a result like the following

{
  "success": {
    "total": 1
  },
  "contents": {
    "id": "vSatyvvGU2fAMAIUgIvjIweF",
    "riddle": "What did the bee say to the flower?",
    "answer": [
      "Hello, honey!"
    ],
    "title": null,
    "category": "",
    "subcategory": "",
  },
  "copyright": {
    "url": "https://api.fungenerators.com",
    "year": "2024"
  }
}

API Rate Limiting for Riddle API

Some of our API calls may be public(requires free API key) , while others requires paid subscription. To maintain our serice levels both public and private API endpoints are ratelimited. Please consult your specific plan that you subscribed to for the rate limit details.

Authenticating with the Riddle API

Currently we support API Key based authentication. Please set your Autorization Bearer request header with value of your API key. Alternatively you can also pass api_key= as a request parameter, though we strongly discourage this mode of passing the key, since it will allow others to see your key.

In curl this would mean sending the Authorization header like below.

            
 curl -i <url> -H "Authorization: Bearer <api_key>"
            
            

If you are using PHP.

            
$authorization = "Authorization: Bearer <api_key>";
$ch = curl_init('<url>'); // Initialise cURL
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json' , $authorization ));
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); // OR GET
$result = curl_exec($ch);
curl_close($ch);
            
            

In javascript you can use headers key to add the authorization header

            
$.ajax({
   url: '<url>'
   type: 'GET',
   contentType: 'application/json'
   headers: {
      'Authorization': 'Bearer <api_key>'
   },
   success: function (result) {
       // CallBack(result);
   },
   error: function (error) {

   }
});