Taunt Generation as a service API

Taunt API gives you API access to taunt generator, so that you can integrate this functionality in your websites or applications.

To access the web version of this functionality click here.

API End Points

	https://api.fungenerators.com
	

Ratelimiting

Some of our API calls are public. To maintain our service level we ratelimit the number of API calls. For public API calls this is 60 API calls a day with distribution of 5 calls an hour. For paid plans this limit is increased according to the service level described in the plan.

Authentication

For public calls you don't need to pass any API key. Just invoke the endpoint (see examples below). For paid subscriptions you need to pass the API key.

Currently we support API Key based authentication. Please set a request header 'X-FunGenerators-Api-Secret' 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.

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=3

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 Console

The following are the API calls you can make. You can try out / test the calls right from this page. Please note, javascript needs to be enabled to see the documentation below.

Subscribe