Documentation
Images
Search for a Tag

Search for a Tag

This endpoint allows you to search for a tag, filtering by name, description, and whether it's NSFW or not.

Endpoint Details

  • URL: /v3/images/tags
  • Method: GET
  • Response: JSON

Parameters

LocationNameTypeDescriptionRequired
QuerysearchStringSearch term. Will return all tags with this term(s) in their name or description.No
Queryis_nsfwBooleanWhether the tag is NSFW or not.No
QuerylimitInteger [1..100]The amount of tags to return.No
QueryoffsetIntegerThe amount of tags to skip.No

Example Request

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