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
Location | Name | Type | Description | Required |
---|---|---|---|---|
Query | rating | Array of strings [safe, suggestive, borderline, explicit] | The (age) rating of the image. | No |
Query | artist | Array of integers | The artist's ID. | No |
Query | tags | Array of strings | The tags names, comma-delimited. | No |
Query | without_tags | Array of strings | The tags to exclude's names, comma-delimited. | No |
Query | limit | Integer [1..100] | The amount of images to return. | No |
Query | offset | Integer [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()