Taunt Generation API

Generate random fun taunts (insults) in many categories.That is right...Software as a Service (SaaS) is so lame...Insult as a Service (IaaS) is the new shiny thing in town.

Here are some samples

We support more than 15 categories of insults. You pick and chose based on your application needs. Thousands and thousands of possiblities. Here are some samples to give you an idea.

Sci-Fi Insults

sequenceDiagram You->>IaaS: /generate?category=scifi-insult IaaS-->>You: You salt spined hydrogen based weirdo IaaS-->>You: You slime flippered warty toffee droid IaaS-->>You: You radioactive silicon based mud stink

Harry Potter Insults

sequenceDiagram You->>IaaS: /generate?category=harry-potter IaaS-->>You: Dragon Bogies! You Toss pot Slughorn IaaS-->>You: Gallopin’ Gorgons! You Wand-waving Mudblood

Liberal Insults

sequenceDiagram You->>IaaS: /generate?category=liberal-insult IaaS-->>You: You godless tax-and-spending pacifist IaaS-->>You: You clueless Birkenstock-wearing granolacrat

Conservative Insults

sequenceDiagram You->>IaaS: /generate?category=conservative-insult IaaS-->>You: You backwoods cousin-marrying troll IaaS-->>You: You uninformed piety-pretending yahoo

Shakespeare Insults

sequenceDiagram You->>IaaS: /generate?category=shakespeare IaaS-->>You: Thou venomed earth-vexing scullion! IaaS-->>You: Thou dankish tardy-gaited dewberry!

And many more...

API End Points

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

	https://api.fungenerators.com

API Documentation

Get all the supported taunt categories

To get the all the supported categories for taunt generation use the following endpoint.

   GET /taunt/categories.json?start=0&limit=5

The result should look something like this.

{
  "success": {
    "total": "7",
    "start": 0,
    "limit": 10
  },
  "contents": [
    [
      {
        "name": "new-age-insult",
        "title": "Random Insult Generator",
        "description": "Nothing personal mate! Just for fun! This is not appropriate for children!"
      },
      {
        "name": "shakespeare",
        "title": "Random Shakespearean Curse Generator",
        "description": "Generates a random Shakespeare sounding curse every-time you visit the page. Cursing is bad for health ;) , use it only when necessary."
      },
      {
        "name": "lutheran-insult",
        "title": "Random Lutheran Insult Generator",
        "description": "Let Luther insult you from the history! These insults directly from the books of Luther will make you feel like the real Hanswursts - blockheads, boors, and dunderheads."
      },
      {
        "name": "scottish",
        "title": "Random Scottish Insult Generator",
        "description": "If you are insulting someone insult like Scot! Our Scottish insult generator will be your mate and do most of job for you!"
      },
      {
        "name": "pirate-insult",
        "title": "Pirate Insult Generator",
        "description": "If you are insulting someone insult like Pirate! Our Pirate insult generator will make you a weasel hearted worm suckin' spineless bastitch !"
      },
      {
        "name": "conservative-insult",
        "title": "Conservative Insult Generator",
        "description": "If you are in a political argument and need to insult the conservative on the other side in a hurry, our conservative insult generator will do the job for you!"
      },
      {
        "name": "liberal-insult",
        "title": "Liberal Insult Generator",
        "description": "If you are in a political argument and need to insult the liberal on the other side in a hurry, our liberal insult generator will do the job for you!"
      }
    ]
  ]
}

Generate taunts in a given category

To generate taunts in a given a category use this end point.

   GET /taunt/generate?category=shakespeare&limit=5

The above should produce something like the following as a API result.

{
  "success": {
    "total": null,
    "limit": 5
  },
  "contents": {
    "category": "shakespeare",
    "taunts": [
      "Thou venomed earth-vexing scullion!",
      "Thou dankish tardy-gaited dewberry!",
      "Thou hideous ill-nurtured jack-a-nape!",
      "Thou wenching flap-mouthed malignancy!",
      "Thou droning raw-boned giglet!"
    ]
  },
  "copyright": "https://fungenerators.com/"
}

API Rate Limiting for Taunt Generation 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 Taunt Generation 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) {

   }
});