<< Back to the developer hub

API Documentation


List API - /api/list.php

Query string parameters

shuffle - Shuffle the results.

Sample reply

[
    {
        "uid": "Opening1-11eyes",
        "song": {
            "title": "Sequentia",
            "artist": "Asriel"
        },
        "source": "11eyes"
    }, {
        "uid": "Ending1-11eyes",
        "song": {
            "title": "Arrival of Tears",
            "artist": "Ayane"
        },
        "source": "11eyes"
    }, And so on...
]

Details API - /api/details.php

This API will try to return the metadata for the requested video, or a random video if one isn't specified. The main parameters to use are uid for getting a specific video, skip_{type} for skipping certain video types, and strict for if you only want to get an exact match. The other parameters are more for internal use if you want to get the next video in the sequence, and they will be returned by this API for you to use.

Query string parameters

uid - The unique ID of the video to get.

seed - The main seed to be used by the random number generator. If a seed is not given, a random one will be generated.

seed_b - A second seed to be used by the random number generator. This one exists for performance reasons.

index_{behavior} - The index of the random video of a random behavior to get.

seen_last_{behavior} - The number of videos previously returned of the specified behavior. Used to determine whether or not to show a video that is set to be shown on an interval.

skip_{type} - The video types to skip. True for '', '1', 'true', 'on', or 'yes'.

strict - Whether or not to find an exact match. True for '', '1', 'true', 'on', or 'yes'.

The parameters with a {behavior}/{type} can appear multiple times, with each appearance corresponding to one behavior/type. These parameters are case-sensitive.

Full possible reply

This is all of the possible values that can be returned. However, none of them are guaranteed to be returned.

{
    "data": {
        "title": "< the title of the video >",
        "file": "< the video's file name, not including the extension >",
        "width": < the video's width >,
        "height": < the video's height >,
        "mime": [< a list of the available encodings of this video, as mime types, sorted from smallest to largest by file size >],
        "type": "< this video's type >",
        "uid": "< the unique identifier for this video >",
        "song": {
            "title": "< the title of this video's song >",
            "artist": "< the artist of this video's song >"
        },
        "subtitles": "< the name of the group that made the subtitles for this video >",
        "source": "< the ip/series that this video is from >",
        "path": "< the path to get to this video's files >",
        "hidden": < true/false if this video is hidden >
    },
    "next": {
        "seed": ..., // an integer greater than 0
        "seed_b": ..., // an integer greater than 0
        "index_{behavior}": ..., // an integer greater than 0
        "seen_last_{behavior}": ..., // an integer greater than 0
        "skip_{type}": true, // if this video type was skipped
        "strict": true // if strict mode was used
    },
    "comment": "< a comment or error message >"
}

Sample reply

To get the details of this video you would use /api/details.php?name=Opening1-Nekomonogatari(Kuro):TsubasaFamily

{
    "data": {
        "title": "Opening 1",
        "file": "Nekomonogatari(Kuro)-OP01-NCBD",
        "width": 1280,
        "height": 720,
        "mime": ["video/mp4","video/webm;codecs=\"vp9,opus\""],
        "type": "OP",
        "uid": "Opening1-Nekomonogatari(Kuro):TsubasaFamily",
        "song": {
            "title": "perfect slumbers",
            "artist": "Yui Horie"
        },
        "subtitles": "Commie",
        "source": "Nekomonogatari (Kuro): Tsubasa Family",
        "path": "video"
    }
}