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 20 Aug 2026, 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

If TheDogAPI does not fit, these entertainment apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.