Dog API

The internet's biggest collection of open-source dog pictures. Fetching over 20,000 dog images accessible by more than 120 breeds via a free, no-auth REST API returning JSON. Optional alt-text variants pair every image URL with descriptive text for accessibility.

1 APIs 0 Features

DogsImagesOpen DataOpen Source

APIs

Dog API

The Dog API (dog.ceo) is the internet's largest collection of open-source dog pictures, exposing over 20,000 images across 120+ breeds. The API requires no authentication and re...

Collections

Dog API

OPEN

Pricing Plans

Dog Api Plans Pricing

3 plans

PLANS

Rate Limits

Dog Api Rate Limits

5 limits

RATE LIMITS

FinOps

Dog Api Finops

FINOPS

Semantic Vocabularies

Dog Api Context

9 classes · 4 properties

JSON-LD

Dog Api Context

10 classes · 0 properties

JSON-LD

API Governance Rules

Dog API API Rules

34 rules · 14 errors 19 warnings 1 info

SPECTRAL

JSON Structure

Dog Api Alt Image List Response Structure

2 properties

JSON STRUCTURE

Dog Api Alt Image Structure

2 properties

JSON STRUCTURE

Dog Api Breed List Response Structure

2 properties

JSON STRUCTURE

Dog Api Error Response Structure

3 properties

JSON STRUCTURE

Dog Api Image List Response Structure

2 properties

JSON STRUCTURE

Dog Api Image Response Structure

2 properties

JSON STRUCTURE

Dog Api String List Response Structure

2 properties

JSON STRUCTURE

Dog Api String Response Structure

2 properties

JSON STRUCTURE

Example Payloads

Breed Images

2 fields

EXAMPLE

Dog Api Alt Image Example

2 fields

EXAMPLE

Dog Api Alt Image List Response Example

2 fields

EXAMPLE

Dog Api Breed List Response Example

2 fields

EXAMPLE

Dog Api Error Response Example

3 fields

EXAMPLE

Dog Api Image List Response Example

2 fields

EXAMPLE

Dog Api Image Response Example

2 fields

EXAMPLE

Dog Api String List Response Example

2 fields

EXAMPLE

Dog Api String Response Example

2 fields

EXAMPLE

List All Breeds

2 fields

EXAMPLE

Random Image

2 fields

EXAMPLE

Resources

Documentation

MCP Server (Community)

p5.js Example

Vanilla JS Example

jQuery Example

Flutter Example

Node.js Example

Sources

opencollection: 1.0.0
info:
  name: Dog API
  version: 1.1.0
items:
- info:
    name: Breeds
    type: folder
  items:
  - info:
      name: Dog API List All Breeds
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/list/all
    docs: Returns the complete master breed list with each breed's sub-breeds (if any).
  - info:
      name: Dog API Random Breed Entry
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/list/all/random
    docs: Returns a single randomly selected entry from the master breed list (one breed mapped to its sub-breeds).
  - info:
      name: Dog API Multiple Random Breed Entries
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/list/all/random/:amount
      params:
      - name: amount
        value: '3'
        type: path
        description: Number of random breed entries to return.
    docs: Returns multiple randomly selected entries from the master breed list.
  - info:
      name: Dog API List Top-Level Breeds
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/list
    docs: Returns the list of all top-level (master) breed names without sub-breeds.
  - info:
      name: Dog API Random Top-Level Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/list/random
    docs: Returns a single randomly selected top-level breed name.
  - info:
      name: Dog API Multiple Random Top-Level Breeds
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/list/random/:amount
      params:
      - name: amount
        value: '3'
        type: path
        description: Number of random top-level breed names to return.
    docs: Returns multiple randomly selected top-level breed names.
  - info:
      name: Dog API List Sub-Breeds
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/list
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name (e.g., hound, retriever, spaniel).
    docs: Returns the list of sub-breeds for the given master breed.
  - info:
      name: Dog API Random Sub-Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/list/random
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
    docs: Returns a single random sub-breed for the given master breed.
  - info:
      name: Dog API Multiple Random Sub-Breeds
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/list/random/:amount
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: amount
        value: '3'
        type: path
        description: Number of random sub-breeds to return.
    docs: Returns multiple random sub-breeds for the given master breed.
- info:
    name: Images
    type: folder
  items:
  - info:
      name: Dog API List Images by Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/images
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
    docs: Returns all image URLs for a given master breed.
  - info:
      name: Dog API Random Image by Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/images/random
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
    docs: Returns a single random image URL for the given master breed.
  - info:
      name: Dog API Multiple Random Images by Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/images/random/:amount
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: amount
        value: '3'
        type: path
        description: Number of random images to return.
    docs: Returns multiple random image URLs for the given master breed.
  - info:
      name: Dog API List Images by Sub-Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/:subBreed/images
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: subBreed
        value: afghan
        type: path
        description: Sub-breed name.
    docs: Returns all image URLs for a given sub-breed.
  - info:
      name: Dog API Random Image by Sub-Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/:subBreed/images/random
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: subBreed
        value: afghan
        type: path
        description: Sub-breed name.
    docs: Returns a single random image URL for the given sub-breed.
  - info:
      name: Dog API Multiple Random Images by Sub-Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/:subBreed/images/random/:amount
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: subBreed
        value: afghan
        type: path
        description: Sub-breed name.
      - name: amount
        value: '3'
        type: path
        description: Number of random images to return.
    docs: Returns multiple random image URLs for the given sub-breed.
  - info:
      name: Dog API Random Image From Any Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/image/random
    docs: Returns a random dog image URL from any breed.
  - info:
      name: Dog API Multiple Random Images From Any Breed
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/image/random/:amount
      params:
      - name: amount
        value: '3'
        type: path
        description: Number of random images to return.
    docs: Returns multiple random dog image URLs from any breed.
  - info:
      name: Dog API Multiple Random Images From Any Breed With Alt Text
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breeds/image/random/:amount/alt
      params:
      - name: amount
        value: '3'
        type: path
        description: Number of random images to return.
    docs: Returns multiple random images from any breed paired with descriptive alt text.
  - info:
      name: Dog API List Images by Breed With Alt Text
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/images/alt
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
    docs: Returns all images for the given master breed paired with descriptive alt text.
  - info:
      name: Dog API Multiple Random Images by Breed With Alt Text
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/images/random/:amount/alt
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: amount
        value: '3'
        type: path
        description: Number of random images to return.
    docs: Returns multiple random images for the given master breed paired with descriptive alt text.
  - info:
      name: Dog API List Images by Sub-Breed With Alt Text
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/:subBreed/images/alt
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: subBreed
        value: afghan
        type: path
        description: Sub-breed name.
    docs: Returns all images for the given sub-breed paired with descriptive alt text.
  - info:
      name: Dog API Multiple Random Images by Sub-Breed With Alt Text
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/:subBreed/images/random/:amount/alt
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: subBreed
        value: afghan
        type: path
        description: Sub-breed name.
      - name: amount
        value: '3'
        type: path
        description: Number of random images to return.
    docs: Returns multiple random images for the given sub-breed paired with descriptive alt text.
- info:
    name: Info
    type: folder
  items:
  - info:
      name: Dog API Get Breed Info
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
    docs: Returns free-text descriptive information about the given master breed when available.
  - info:
      name: Dog API Get Sub-Breed Info
      type: http
    http:
      method: GET
      url: https://dog.ceo/api/breed/:breed/:subBreed
      params:
      - name: breed
        value: hound
        type: path
        description: Master breed name.
      - name: subBreed
        value: afghan
        type: path
        description: Sub-breed name.
    docs: Returns free-text descriptive information about the given sub-breed when available.
bundled: true