Search

  • All Images are available via GET https://api.thedogapi.com/images/search
  • You can use Query Parameters to filter by File type, Category & Breed.
    • Full List of available parameters in the /images API Reference in the left menu

Pagination & Ordering

  • The results of /images/search or /images routes can be paginated through, using the limit and page query parameters.

    • limit is the amount of images to return
    • page is the results page to return, 0 is the first.
  • NOTE: Pagination can only be performed when the order query parameter is Desc or Asc - Not the default Rand

  • The total amount of Images available that match the query is returned as the Pagination-Count header

https://api.thedogapi.com/v1/images/search?limit=5&page=10&order=desc - would return 5 Images, from page 10 of entire collection in Descending order

Example - Paginating through Search results
  1. This Example requests https://api.thedogapi.com/v1/images/search?limit=3&page=100&order=DESC
  2. This returns 3 images from page 100 of the entire collection, in Descending order

You can change the order, page or limit to see the result for yourself.

object

The Image object returned to the public via GET /images/search

id
string
url
string
format: uri
categories
array[object]
id
number
name
string
breeds
array[object]
id
string
name
string
temperament
string
life_span
string
alt_names
string
wikipedia_url
string
origin
string
weight
object
country_code
string
height
object