Name Generation API

Generate random names in many categories

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 categories

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

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

The result should look something like this.

{
  "success": {
    "total": "37",
    "start": 0,
    "limit": 5
  },
  "contents": [
    [
      {
        "name": "elf",
        "title": "Elf Name Generator",
        "suggestion_supported": "0",
        "unisex": false
      },
      {
        "name": "super-hero",
        "title": "Superhero Name generator",
        "suggestion_supported": "0",
        "unisex": true
      },
      {
        "name": "alien",
        "title": "Alien Name generator",
        "suggestion_supported": "0",
        "unisex": true
      },
      {
        "name": "dragon",
        "title": "Dragon Name generator",
        "suggestion_supported": "0",
        "unisex": true
      },
      {
        "name": "indian",
        "title": "Indian Name generator",
        "suggestion_supported": "0",
        "unisex": false
      }
    ]
  ]
}

Generate names in a given category

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

   GET /name/generate?category=car&limit=10

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

{
  "success": {
    "total": null,
    "start": 0,
    "limit": 10
  },
  "contents": {
    "category": "car",
    "variation": null,
    "names": [
      "Mythic",
      "Intro",
      "Orbit",
      "Barrage",
      "Quicksilver",
      "Lioness",
      "Spire",
      "Tigress",
      "Essence",
      "Trailblazer"
    ]
  },
  "copyright": "https://fungenerators.com/"
}

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

   }
});