Dog API

How to Use This API

1. List All Dog Breeds with Details

https://dogapi.dog/api/v1/breeds

Returns all breeds with id, name, breed group, life span, temperament, weight (imperial/metric), and height.

2. Random Dog Image

https://dogapi.dog/api/v1/images/random

Get a single random dog image with breed info attached.

3. Get Multiple Random Images

https://dogapi.dog/api/v1/images/random?limit=5

Returns up to 5 random dog images with breed information in one request.

4. JavaScript — Breed Directory

async function listBreedsByGroup(groupName) {
  const resp = await fetch('https://dogapi.dog/api/v1/breeds');
  const { data: breeds } = await resp.json();
  
  return breeds
    .filter(b => b.attributes.breed_group === groupName)
    .map(b => ({
      name: b.attributes.name,
      life: b.attributes.life_span,
      temperament: b.attributes.temperament,
      weight: b.attributes.weight.imperial
    }));
}

async function showHerdingDogs() {
  const dogs = await listBreedsByGroup('Herding');
  console.log(`Found ${dogs.length} herding breeds`);
  dogs.forEach(d => {
    console.log(`${d.name} — Life: ${d.life}, Weight: ${d.weight} lbs`);
  });
}

showHerdingDogs();

5. Python — Fetch Dog with Image

import requests

def random_dog_with_info():
    resp = requests.get('https://dogapi.dog/api/v1/images/random')
    data = resp.json()
    
    dog = data['data'][0]
    img_url = dog['attributes']['url']
    breed = dog['relationships']['breeds']['data'][0]
    
    breed_resp = requests.get(
        f"https://dogapi.dog/api/v1/breeds/{breed['id']}"
    )
    breed_data = breed_resp.json()['data']['attributes']
    
    print(f"Breed: {breed_data['name']}")
    print(f"Group: {breed_data['breed_group']}")
    print(f"Temperament: {breed_data['temperament']}")
    print(f"Life span: {breed_data['life_span']}")
    print(f"Image: {img_url}")

random_dog_with_info()