API

Documentation for the God List's API. Questions or suggestions? Join our Discord.

GET /api/list

Response: A JSON table containing information about all the list entries.


Example Response:

{
	"table": [
		{
			"id": 1,
			"link": "https://nhentai.net/g/169217",
            "title": "Torakaburi??",
			"author": "Kiiroi Tamago",
			"note": "None",
			"parody": "None",
			"tier": "S",
			"pages": "24",
			"misc": "None",
			"image": "https://wholesomelist.com/asset/c0dce112-56c9-4246-8474-5ced0f7d8387.jpg",
			"uuid": "c0dce112-56c9-4246-8474-5ced0f7d8387",
			"tags": [
				"Handholding",
				"High School",
				"Tsundere"
            ]
		},
		{
			"id": 2,
			...
		},
		...
	]
}

GET /api/features

Response: A JSON table containing information about all the currently featured doujins (from the front page of the site).


Example Response:

{
	"table": [
		{
            "link": "https://wholesomelist.com/list/76da199e-6e98-4b1c-90fb-39492dedfdd5",
            "title": "Bokura wa ○○ Hanare ga Dekina Ketsuron",
            "author": "Herio",
            "tier": "S-",
            "img": "https://wholesomelist.com/asset/76da199e-6e98-4b1c-90fb-39492dedfdd5.jpg"
		},
		{
			"link": ...
			...
		},
		...
	]
}

GET /api/updates

Response: A JSON table containing information about the 10 most recently-added doujins in the list. Includes a UNIX timestamp of when the title was added (in milliseconds).


Example Response:

{
	"table": [
		{
            "title": "Bokura wa ○○ Hanare ga Dekina Ketsuron",
			"author": "Herio",
			"link": "https://wholesomelist.com/list/76da199e-6e98-4b1c-90fb-39492dedfdd5",
			"tier": "S-",
			"time": "1624415934185"
		},
		{
			"title": ...
			...
		},
		...
	]
}

GET /api/check

Takes an argument in the URL for a code (i.e. GET /api/check?code=258133). The "code" can be either an imgur hash (i.e. https://imgur.com/a/s63fSgh has a hash code of s63fSgh) or an nhentai number.


Response: A result, which is either true or false depending on if the doujin was found or not, and if it was, information about the corresponding entry.


Example Response:

{
	"result": true,
    "entry": {
        "id": 364,
        "link": "https://nhentai.net/g/258133",
        "title": "Summer and Innocence",
        "author": "Jorori",
        "note": "None",
        "parody": "None",
        "tier": "S",
        "pages": "22",
        "misc": {
            "altLinks": [
				{
                    "link": "https://imgur.com/a/emJBX0D",
                    "name": "Colorized Version"
				}
			],
            "favorite": "Sting",
            "reason": "Iconic. Also saved me a lot of work making wholesomelist.com branding."
        },
        "image": "https://wholesomelist.com/asset/82838586-9723-4358-9076-748f56bd40af.jpg",
        "uuid": "82838586-9723-4358-9076-748f56bd40af",
        "tags": "Full Color, High School"
    }
}

GET /api/random

Response: A JSON entry containing the information for a random entry from the God List.


Example Response:

{
	"entry": {
		"id": 1,
		"link": "https://nhentai.net/g/169217",
        "title": "Torakaburi??",
		"author": "Kiiroi Tamago",
		"note": "None",
		"parody": "None",
		"tier": "S",
		"pages": "24",
		"misc": "None",
		"image": "https://wholesomelist.com/asset/c0dce112-56c9-4246-8474-5ced0f7d8387.jpg",
		"uuid": "c0dce112-56c9-4246-8474-5ced0f7d8387",
		"tags": [
			"Handholding",
			"High School",
			"Tsundere"
		]
	}
}