🔞Retrieve NSFW media

This page contains API endpoints that you can use to pull NSFW media from our huge database of images and GIFs.

Grab a list of types and categories as a JSON response

GET https://api.hentaicord.net/types-categories

200: OK Successful response.

{
    "code": 200,
    "message": "Success",
    "categories": {
        "hentai": ["list", "of", "categories"],
        "real_porn": ["list", "of", "categories"],
        "roleplay": ["list", "of", "categories"]
    },
    "calls_remaining": 99
}

Retrieve a random image from the specified parameters.

GET https://api.hentaicord.net/retrieve/:type/:category

Path Parameters

Name	Type	Description
type*	String	hentai, real-porn or roleplay
category*	String	One of the categories from your selected 'type'.

Headers

Name	Type	Description
Authorization*	String	Your API token

200: OK Successfully Retrieved Content

{
    "code": 200,
    "message": "Success",
    "image": "IMAGE URL WILL BE PROVIDED",
    "selected": {
        "type": "hentai", // Will be the type you chosen.
        "category": "boobs" // Will be the category you chosen.
    },
    "calls_remaining": 99
}