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,
			"hm": null,
            "nh": "https://nhentai.net/g/169217",
            "eh": null,
            "im": null,
            "title": "Torakaburi??",
			"author": "Kiiroi Tamago",
			"note": null,
			"parody": null,
			"tier": "S",
			"pages": 24,
			"misc": null,
			"siteTags": {
                "tags": [
                    "sole female",
                    "sole male",
					"schoolgirl uniform",
                    "mosaic censorship",
                    "defloration",
                    "schoolboy uniform",
                    "condom",
                    "virginity"
                ],
                "characters": []
            },
			"image": "https://wholesomelist.com/asset/c0dce112-56c9-4246-8474-5ced0f7d8387.jpg",
			"uuid": "c0dce112-56c9-4246-8474-5ced0f7d8387",
			"tags": [
				"Handholding",
				"High School",
				"Tsundere"
            ]
			"link": "https://nhentai.net/g/169217",
		},
		{
			"id": 2,
			...
		},
		...
	]
}

GET /api/licensed

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


Example Response:

{
	"table": [
		{
            "id": 1,
            "title": "Mistaken Love",
            "author": "Suruga Kuroitsu",
            "note": null,
            "parody": null,
            "tier": "S",
            "pages": 30,
            "misc": null,
            "siteTags": null,
            "image": "https://wholesomelist.com/asset/401fbf46-450c-4efc-bb5f-cfb6cd7e6c21.jpg",
            "uuid": "401fbf46-450c-4efc-bb5f-cfb6cd7e6c21",
            "tags": [
                "Couple",
                "Gyaru",
                "Handholding",
                "High School",
                "Tall",
                "Tomboy",
                "Tsundere"
            ],
            "link": "https://www.fakku.net/hentai/mistaken-love-english"
        },
		{
			"id": 2,
			...
		},
		...
	]
}

GET /api/features

Response: A JSON table containing information about all the currently featured h-manga (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 h-manga 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=262340). The "code" can be either an Imgchest hash (i.e. https://www.imgchest.com/p/n87wezbg7xd has a hash code of n87wezbg7xd) , an nhentai number, or an e-hentai gallery token (i.e. https://e-hentai.org/g/1360792/4361ae7e8b/ has a gallery token of 4361ae7e8b).


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


Example Response:

{
    "result": true,
    "entry": {
        "id": 355,
        "hm": "https://hmarket.io/shop/i-love-you/",
        "nh": "https://nhentai.net/g/262340",
        "eh": "https://e-hentai.org/g/1360792/4361ae7e8b/",
        "im": null,
        "title": "Summer and Innocence",
        "author": "Jorori",
        "note": null,
        "parody": null,
        "tier": "S",
        "pages": 22,
        "misc": {
            "altLinks": [
                {
                    "link": "https://www.imgchest.com/p/na7kdvpk48d",
                    "name": "Colorized Version"
                },
                {
                    "link": "https://www.imgchest.com/p/md7oeqpa4p6",
                    "name": "Uncensored Version"
                },
                {
                    "link": "https://myanimelist.net/anime/44192/Kimi_ga_Suki_The_Animation",
                    "name": "MAL (Animation)"
                }
            ],
            "favorite": "Sting",
            "reason": "Iconic. Also saved me a lot of work making wholesomelist.com branding."
        },
        "siteTags": {
            "tags": [
                "male:condom",
                "male:sole male",
                "female:beauty mark",
                "female:big breasts",
                "female:defloration",
                "female:kimono",
                "female:kissing",
                "female:nakadashi",
                "female:sole female",
                "female:sweating",
                "other:full censorship"
            ],
            "characters": []
        },
        "image": "https://wholesomelist.com/asset/82838586-9723-4358-9076-748f56bd40af.jpg",
        "uuid": "82838586-9723-4358-9076-748f56bd40af",
        "tags": [
            "Full Color",
            "High School",
            "Uncensored"
        ],
        "link": "https://hmarket.io/shop/i-love-you/"
    }
}

GET /api/random

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


Example Response:

{
    "result": true,
    "entry": {
        "id": 1,
        "hm": null,
        "nh": "https://nhentai.net/g/169217",
        "eh": null,
        "im": null,
        "title": "Torakaburi??",
        "author": "Kiiroi Tamago",
        "note": null,
        "parody": null,
        "tier": "S",
        "pages": 24,
        "misc": null,
        "siteTags": {
            "tags": [
                "sole female",
                "sole male",
                "schoolgirl uniform",
                "mosaic censorship",
                "defloration",
                "schoolboy uniform",
                "condom",
                "virginity"
            ],
            "characters": []
        },
        "image": "https://wholesomelist.com/asset/c0dce112-56c9-4246-8474-5ced0f7d8387.jpg",
        "uuid": "c0dce112-56c9-4246-8474-5ced0f7d8387",
        "tags": [
            "Handholding",
            "High School",
            "Tsundere"
        ],
        "link": "https://nhentai.net/g/169217"
    }
}

GET /api/random-licensed

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


Example Response:

{
	"result": true,
	"entry": {
		"id": 1,
		"title": "Mistaken Love",
		"author": "Suruga Kuroitsu",
		"note": null,
		"parody": null,
		"tier": "S",
		"pages": 30,
		"misc": null,
		"siteTags": {
			"tags": [
				"unlimited",
				"ahegao",
				"condom",
				"deepthroat",
				"delinquent",
				"fingering",
				"leg lock",
				"light hair",
				"mating press",
				"short hair",
				"squirting",
				"tomboy",
				"tsundere",
				"uncensored",
				"vanilla",
				"x-ray"
			],
			"characters": []
		},
		"image": "https://wholesomelist.com/asset/401fbf46-450c-4efc-bb5f-cfb6cd7e6c21.jpg",
		"uuid": "401fbf46-450c-4efc-bb5f-cfb6cd7e6c21",
		"tags": [
			"Couple",
			"Gyaru",
			"Handholding",
			"High School",
			"Tall",
			"Tomboy",
			"Tsundere"
		],
		"link": "https://www.fakku.net/hentai/mistaken-love-english"
    }
}