Guides / Reference

How to get dog breed images for an app or site

By the Dog Image API team. Updated .

You have five realistic ways to get dog breed images: shoot them yourself, license them from a stock library, call a photo API, collect them from users, or use one standardized illustration set. Pick by what the images must do. Photos suit stories. A matching set suits interfaces that list many breeds.

Option 1: your own photography

Good for: a few breeds that matter a lot to your brand, or images of real animals you can name and show with permission.

Cost: time, a camera, dogs, owners who agree, and editing. Every breed you add is another shoot. Cutting a clean background out of each photo is extra work. For a list of hundreds of breeds this stops being practical.

Choose it when the picture must show a specific real animal, or when originality is the point of the page.

Option 2: stock photo libraries

Good for: a handful of strong editorial photos, such as a header image for an article.

Cost: you usually license per image, and the terms differ by library and by license tier. Read what each license allows for your use, such as apps, print or resale of products, before you buy. Coverage of rarer breeds can be thin, and pictures from different photographers differ in light, crop and background, so a grid of them looks uneven unless you edit each one.

Choose it when you need a few good photos and can accept a mixed look.

Option 3: photo APIs

Good for: many pictures of real dogs, random images for a demo, or search and filters, depending on the service.

Cost: often free to start, with limits or terms that differ by provider. You still get varied photos, so a breed selector may need cropping rules of your own. Our comparison of Dog CEO's Dog API, The Dog API and Dog Image API gives the details we could verify on each service's own pages.

Choose it when real photos matter more than a uniform look.

Option 4: user uploads

Good for: pet profiles, where the owner's own dog is the content.

Cost: you build upload, storage, resizing and moderation, and you handle the rights and privacy questions that come with other people's pictures. New users have no photo yet, so you still need something to show on day one.

Choose it when the product is about the owner's own pet. Pair it with a default image for the empty state.

Option 5: a standardized illustration set

Good for: interfaces that list or compare many breeds: pickers, quizzes, size charts, cards, printed forms, games.

Cost: free previews with a visible credit link, or a paid plan for full-size files. This is the option Dog Image API covers. The catalog held 298 breeds and 329 sets on 2026-11-14. Every set shows one adult dog from the same nine views on a square, transparent canvas. Previews are WebP at 512 and 1024 pixels. Full-size files are 2048 pixel PNGs.

Limits you should weigh: these are AI-generated illustrations. They show no real dog, they are not a breed standard, and each set shows an adult in a standing pose (the head portrait aside). There is no random-image endpoint, no search and no upload.

Choose it when consistency across breeds matters more than photographic realism.

A short decision table

You need Best fit
A real animal, named and shown Your own photography
A few editorial photos Stock library
Many real photos or random pictures Photo API
The owner's own pet User uploads
Every breed in the same view and format Standardized illustration set
A neutral image before the owner uploads Illustration set, then user upload

These options combine well. A site can run photo articles, a matching illustration in its breed picker and an upload slot on the profile page.

How to start with this API in three steps

1. Read the breed list

The list needs no key and browsers on other sites may call it. Build your picker from it instead of hardcoding slugs, so new breeds appear without a deploy.

curl https://dogimage.dev/api/v1/breeds

The reply has views and breeds. Each breed has a slug such as golden-retriever, a default_variant and a crossbreed flag.

2. Show a preview with its credit

An image URL redirects to a WebP preview, which an <img> tag follows. Pick a view id such as front-left, and use default or the breed's variant slug.

<img src="https://dogimage.dev/api/v1/images/samoyed/default/front-left?size=512"
     alt="Illustration of a Samoyed" width="256" height="256">
<a href="https://dogimage.dev/dogs/samoyed">Samoyed image: Dog Image API</a>

Previews can be used commercially as long as that credit link sits next to the image or on the same page.

3. Download full-size files only if you need them

Full-size PNGs need a key and a plan. Run the download on a server or in a build step, store the file yourself and read the key from DOG_IMAGE_API_KEY.

curl -H "Authorization: Bearer $DOG_IMAGE_API_KEY" \
  -o samoyed-front-left.png \
  "https://dogimage.dev/api/v1/images/samoyed/default/front-left?size=full"

A plan counts distinct full-size images each month, and one image is one view of one set. The pricing page lists the plans, and the license says what you may do with the files. Browse the catalog on the breeds page before you decide.

Questions

What is the cheapest way to get dog breed images?

It depends on what you count. Free previews from this API cost no money but need a visible credit link. Your own photography costs no license fees but a lot of time. Stock libraries and photo APIs sit in between, and their terms vary by provider.

Can I mix photos and illustrations on one site?

Yes. Many sites use photos on article pages and illustrations in the interface. Label each so a reader can tell them apart.

Do I need an API key to try Dog Image API?

No. The breed list, the breed details and the 512 and 1024 pixel previews need no key. A key is only for full-size PNG files, and it must stay on a server.

Are the images photos of real dogs?

No. They are AI-generated illustrations of one adult dog per set, not real dogs and not a breed standard.

Next steps