PlaceKitten Image API

openapi: 3.0.3
info:
  title: PlaceKitten Image API
  description: 'PlaceKitten is a placeholder image service that returns kitten photos at the

    requested dimensions. It was a community-favorite stand-in alongside

    placehold.it for designers and developers needing quick image stubs.


    NOTE: As of 2026, the placekitten.com origin returns Cloudflare HTTP 521

    (web server down). The service is treated as deprecated. This specification

    is preserved for historical reference and to document the URL contract that

    third-party SDKs and embeds depended on for over a decade.

    '
  version: 1.0.0
  contact:
    name: Mark James
    url: https://placekitten.com/
  license:
    name: Image attribution — see provider
    url: https://placekitten.com/attribution
  x-status: deprecated
  x-deprecation-notice: placekitten.com origin is unreachable (HTTP 521) as of 2026-05-30. Recommend migrating to placedog.net, picsum.photos, or self-hosted assets.
servers:
- url: https://placekitten.com
  description: Canonical (currently offline)
tags:
- name: Image
  description: Placeholder image retrieval
paths:
  /{width}/{height}:
    get:
      operationId: getKittenImage
      summary: Get Color Kitten Image
      description: 'Returns a color kitten JPEG sized to the requested width and height.

        Both dimensions are positive integers expressed in pixels.

        '
      tags:
      - Image
      parameters:
      - $ref: '#/components/parameters/Width'
      - $ref: '#/components/parameters/Height'
      responses:
        '200':
          description: A color kitten image at the requested dimensions.
          content:
            image/jpeg:
              schema:
                type: string
                format: binary
        '404':
          description: Image could not be produced for the requested size.
        '521':
          description: Origin web server is down (current default response in 2026).
  /g/{width}/{height}:
    get:
      operationId: getGrayscaleKittenImage
      summary: Get Grayscale Kitten Image
      description: 'Returns a grayscale kitten JPEG sized to the requested width and height.

        The leading `/g/` segment toggles the grayscale variant.

        '
      tags:
      - Image
      parameters:
      - $ref: '#/components/parameters/Width'
      - $ref: '#/components/parameters/Height'
      responses:
        '200':
          description: A grayscale kitten image at the requested dimensions.
          content:
            image/jpeg:
              schema:
                type: string
                format: binary
        '404':
          description: Image could not be produced for the requested size.
        '521':
          description: Origin web server is down (current default response in 2026).
components:
  parameters:
    Height:
      name: height
      in: path
      required: true
      description: Image height in pixels.
      schema:
        type: integer
        minimum: 1
        maximum: 2000
        example: 300
    Width:
      name: width
      in: path
      required: true
      description: Image width in pixels.
      schema:
        type: integer
        minimum: 1
        maximum: 2000
        example: 200