Documentation
Images
Get Random Images

Get Random Images

This endpoint allows you to get x random images, filtering by tags, characters, artists, etc.

Endpoint Details

  • URL: /v4/images/random
  • Method: GET
  • Response: JSON

Parameters

LocationNameTypeDescriptionRequired
QueryratingArray of strings [safe, suggestive, borderline, explicit]The (age) rating of the image.No
QueryartistArray of integersThe artist's ID.No
QuerytagsArray of stringsThe tags names, comma-delimited.No
Querywithout_tagsArray of stringsThe tags to exclude's names, comma-delimited.No
QuerylimitInteger [1..100]The amount of images to return.No

Example Request

random_images.py
import requests
 
res = requests.get("https://api.nekosapi.com/v4/images/random")
res.raise_for_status()
 
data = res.json()