Nekogirl API Documentation

Random Image

Overview

Welcome to our API documentation. Here you will find detailed information on how to interact with our API to retrieve data and perform actions.

Please note that we are adding API Keys soon, and there will be some changes to some API endpoints c:

Usage

To use our API, you can send a GET Request through our API as followed

GET https://api.nekogirl.net/v2/neko

GET https://api.nekogirl.net/v2/random

GET https://api.nekogirl.net/v1/fuwamoco

Endpoints

If your image is inside please email us or join our server so we can credit you!

Endpoint Description
/v2/neko Returns A JSON With a url a random url to a random neko image | [Count: 1754]
/v2/random Returns A JSON With a url a random url to a random image | [Count: 3421]
/v1/fuwamoco Returns A JSON With a url a random url to a Fuwawa/Mococo image | [Count: 151]

Errors

If an error occurs while processing your request, the API will return an error response with a status code and a message indicating the reason for the error.

{"error": {"code": 404, "message": "The requested resource was not found"}}

Rate Limiting

To prevent abuse of our API, we have rate limiting in place. The default rate limit is 60 Requests per 1 Minute. If you exceed the rate limit, you will receive a 429 status code.

Examples

Here are some example requests that you can use to interact with our API:

Get a Neko Image

GET https://api.nekogirl.net/v2/neko

Get random Image

GET https://api.nekogirl.net/v2/random

Get Fuwawa & Mococo Image

GET https://api.nekogirl.net/v1/fuwamoco

Conclusion

Thank you for using our API. If you have any questions or issues, please contact our support team at [email protected] or join our support server

If you want to contribute images to our API, feel free to join our support server and create a ticket after verifying!

Contributors

If your name isn't here but your picture is in the API, please inform us so we can credit you.

Catgirls Corporation Community

Angeloid [Contributed Images to random and neko endpoint]