RandomDog

How to Use This API

1. Random Dog (JSON with Image URL)

https://random.dog/woof.json

Returns a JSON object: {"url":"https://random.dog/abc123.jpg","mediaType":"image/jpeg"}

2. Direct Image

https://random.dog/woof

Returns the raw image data directly — ideal for use in an <img> src attribute.

3. Filter by Media Type

https://random.dog/woof.json?filter=mp4

Filter results: mp4 (video), jpg, png, gif. The API will return a random file matching your filter.

4. JavaScript — Random Dog Button

async function getRandomDog() {
  const resp = await fetch('https://random.dog/woof.json');
  const data = await resp.json();
  return data.url;
}

async function displayDog() {
  const img = document.getElementById('dog-image');
  if (img) {
    img.src = await getRandomDog();
    img.alt = 'Random dog';
    img.style = 'max-width:500px;border-radius:10px;';
  }
}

// HTML button: <button onclick="displayDog()">New Dog!</button>
// HTML img: <img id="dog-image" src="" alt="Random dog">

5. Python — Fetch & Save

import requests

def save_random_dog(filename='dog.jpg', filter_type=None):
    params = {}
    if filter_type:
        params['filter'] = filter_type
    
    resp = requests.get(
        'https://random.dog/woof.json',
        params=params
    )
    data = resp.json()
    img_url = data['url']
    
    img_resp = requests.get(img_url)
    with open(filename, 'wb') as f:
        f.write(img_resp.content)
    
    print(f'Saved: {img_url} -> {filename}')

save_random_dog('doggie.jpg', 'jpg')