API

For the time being, Zerochan has a simple read-only API to programmatically request data from its data set.

Anime Image Boards are good data sets for for example machine learning, considering they are often very well labelled and categorised using hierarchical tags.

Requirements and limits

Since the API is read-only at this time, all requests are done using GET.

To access the API, a user-agent header containing the name of your project and your Zerochan username is required. For example: "My AI learning app - MyUsername". The request may still be completed successfully without this custom header, but your project may be banned for being anonymous.

There is a rate limit of 60 requests per minute. Chronically exceeding this limit may result in a ban.

Most endpoints can be accessed by appending the json or xml query string to the 'normal' url.

For example:

/?p=1&json

End point for retrieving all entries. You may use the following query string parameters for filtering. All of these are optional:

p (int)
Page. Use in combination with limit to paginate results.
l (1-250)
Limit, or entries per page. Use in combination with page to paginate results.
s (id|fav)
Sorting order. Sort by either recency (id) or popularity (fav).
t (0|1|2)
Time used for sorting by popularity. 0 indicates all time, 1 indicates the last 7000 entries, 2 indicates the last 15000 entries. This parameters' behavior might be changed soon.
d (large|huge|landscape|portrait|square)
Picture dimensions, you may use this to filter by certain picture dimensions .
c (red|blue|green|...)
Color. Filter entries by certain overall color.

/Genshin+Impact?json

Endpoint for retrieving all entries, filtered by one single tag. This endpoint is not available for meta tags.

/Genshin+Impact?json&strict

Endpoint for retrieving entries in a tag using strict mode, that is, entries where the primary tag is the tag being matched. This endpoint is not available for meta tags.

/Lumine,Flower?json

Filter by multiple tags.

/3793685?json

Detailed information about a single entry.

All Notifications Purge All