Documentation
Images
Search for an Image

Search for an Image

This endpoint allows you to search for an image, filtering by tags, characters, artists, etc.

Endpoint Details

  • URL: /v4/images
  • 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
QueryoffsetInteger [0..]The amount of images to skip.No

Example Request

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