TheDogAPI

Base URL

https://api.thedogapi.com/v1

Authentication

Basic image requests work with no key. A free key unlocks breed filtering, pagination and larger limits.

Rate limit

Keyless requests are limited and return small result sets; a free key raises the allowance.

Pricing

Free tier with optional free key. Paid plans for high volume.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 2026-08-20, and the response shown is the real body it returned — not an illustration.

curl 'https://api.thedogapi.com/v1/images/search'

const res = await fetch("https://api.thedogapi.com/v1/images/search");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.thedogapi.com/v1/images/search", timeout=20)
res.raise_for_status()
print(res.json())

[
  {
    "id": "sGQvQUpsp",
    "url": "https://s3.us-west-2.amazonaws.com/cdn2.thedogapi.com/images/sGQvQUpsp.jpg",
    "width": 1080,
    "height": 1080
  }
]

idstring

Image identifier.

urlstring

Direct image URL, renderable straight into an img tag.

width / heightinteger

Native dimensions — useful for avoiding layout shift.

breedsarray

Breed objects when available, with temperament and measurements.

breeds[].temperamentstring

Comma-separated temperament descriptors.

breeds[].life_spanstring

Typical life expectancy range.

breeds[].bred_for / breed_groupstring

Original purpose and kennel club group.

• Build a dog breed browser with photos and temperament data
• Add pet imagery to an adoption or veterinary site
• Create a breed comparison or selection tool
• Test image handling with real, varied dimensions