Random Cat Images API

Introduction

This API returns random adorable cat avatar and their metadata.

Endpoints

Get an adorable cat avatar image:

• GET /api/v1/images Image format is determined by the Accept header, prefer image/webp if supported.
• GET /api/v1/images?format=png Return the image in image/png format.
• GET /api/v1/images?format=webp Return the image in image/webp format.

Get metadata for an adorable cat avatar:

• GET /api/v1/json The JSON response example:

  {
        "url": {
            "png": "a valid PNG image URL",
            "webp": "a valid WebP image URL"
        },
        "width": number,
        "height": number
    }

Image metadata includes the URL, width, and height of the image.

Usage Limits

This API is free, but it is rate-limited to 1,000 requests per day per IP address, if you need more, please add cache rules to your website.

For fair-use, we recommend you to cache the images and metadata for at least 24 hours (86400 seconds) or longer.