Search for a Character

This endpoint allows you to search for a character, filtering by name, aliases, description, etc.

Endpoint Details

Location	Name	Type	Description	Required
Query	`search`	String	Search term. Will return all characters with this term(s) in their name, aliases, or description.	No
Query	`age`	Integer	One or more of the character's (official) ages.	No
Query	`gender`	String	The character's gender.	No
Query	`species`	String	The character's species.	No
Query	`nationality`	String	The character's nationality.	No
Query	`occupation`	String	One or more of the character's occupations.	No
Query	`limit`	Integer [1..100]	The amount of characters to return.	No
Query	`offset`	Integer	The amount of characters to skip.	No

characters.py

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