Name Generation API

Namegen API gives you API access to namegen 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 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 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