The Dog API

https://docs.thedogapi.com/
Admin
The Dog API provides developers with access to a comprehensive database of dog breeds, allowing them...
Tokens:44,125
Snippets:234
Trust Score:7.9
Update:1 year ago
Show doc for...
Tokens:
Raw
### Example JSON Response for Image Search

Source: https://docs.thedogapi.com/es/reference

An example of a successful JSON response when searching for dog images, including image details and breed information.

```JSON
[
  {
    "id": "6euYVVE_u",
    "url": "https://cdn2.thedogapi.com/images/6euYVVE_u.jpg",
    "width": 1024,
    "height": 685,
    "breeds": [
      {
        "weight": {
          "imperial": "23 - 28",
          "metric": "10 - 13"
        },
        "height": {
          "imperial": "15.5 - 20",
          "metric": "39 - 51"
        },
        "id": 111,
        "name": "Finnish Spitz",
        "bred_for": "Hunting birds, small mammals",
        "breed_group": "Non-Sporting",
        "life_span": "12 - 15 years",
        "temperament": "Playful, Loyal, Independent, Intelligent, Happy, Vocal",
        "reference_image_id": "3PjHlQbkV"
      }
    ]
  }
]
```

--------------------------------

### Example JSON Response for Image Search

Source: https://docs.thedogapi.com/reference

An example of the JSON response structure when searching for dog images. It includes image details, dimensions, and associated breed information.

```JSON
[
  {
    "id": "6euYVVE_u",
    "url": "https://cdn2.thedogapi.com/images/6euYVVE_u.jpg",
    "width": 1024,
    "height": 685,
    "breeds": [
      {
        "weight": {
          "imperial": "23 - 28",
          "metric": "10 - 13"
        },
        "height": {
          "imperial": "15.5 - 20",
          "metric": "39 - 51"
        },
        "id": 111,
        "name": "Finnish Spitz",
        "bred_for": "Hunting birds, small mammals",
        "breed_group": "Non-Sporting",
        "life_span": "12 - 15 years",
        "temperament": "Playful, Loyal, Independent, Intelligent, Happy, Vocal",
        "reference_image_id": "3PjHlQbkV"
      }
    ]
  }
]
```

--------------------------------

### Get Dog Image Analysis

Source: https://docs.thedogapi.com/docs/examples/images

Retrieves an analysis of a specific dog image. Requires an API key and the image ID.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/analysis
```

--------------------------------

### Get Dog Image Analysis

Source: https://docs.thedogapi.com/ru/docs/examples/images

Retrieves an analysis of a specific dog image, likely containing breed predictions or other metadata. Requires an API key and the image ID.

```bash
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/analysis
```

--------------------------------

### Get Dog Image Analysis

Source: https://docs.thedogapi.com/de/docs/examples/images

Retrieves an analysis of a specific dog image, identified by its ID. Requires an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/analysis
```

--------------------------------

### Get Dog Image Analysis

Source: https://docs.thedogapi.com/ja/docs/examples/images

Retrieves an analysis of a specific dog image, identified by IMAGE_ID. This feature requires an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/analysis
```

--------------------------------

### Get Favorite Images Response Sample

Source: https://docs.thedogapi.com/pt-BR/reference

This is a sample JSON response for retrieving a list of favorite images. It includes image details, user ID, and creation timestamp.

```json
[
  {
    "id": 232413577,
    "user_id": "1ejqec",
    "image_id": "asf2",
    "sub_id": "my-user-1234",
    "created_at": "2023-10-28T17:39:28.000Z"
  }

]
```

--------------------------------

### Get Random Dog Facts

Source: https://docs.thedogapi.com/es/docs/examples/facts

Retrieves a specified number of random dog facts. Requires an API key for authentication.

```bash
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/facts?limit=1
```

--------------------------------

### Get Favorite Images Response Sample

Source: https://docs.thedogapi.com/ja/reference

This is a sample JSON response for retrieving a list of favorite images. It includes image details, user ID, and creation timestamp.

```json
[
  {
    "id": 232413577,
    "user_id": "1ejqec",
    "image_id": "asf2",
    "sub_id": "my-user-1234",
    "created_at": "2023-10-28T17:39:28.000Z"
  }

]
```

--------------------------------

### Get Favorite Images Response Sample

Source: https://docs.thedogapi.com/es/reference

This is a sample JSON response for retrieving a list of favorite images. It includes image details, user ID, and creation timestamp.

```json
[
  {
    "id": 232413577,
    "user_id": "1ejqec",
    "image_id": "asf2",
    "sub_id": "my-user-1234",
    "created_at": "2023-10-28T17:39:28.000Z"
  }

]
```

--------------------------------

### Get Favorite Images Response Sample

Source: https://docs.thedogapi.com/reference

This is a sample JSON response for retrieving a list of favorite images. It includes image details, user ID, and creation timestamp.

```json
[
  {
    "id": 232413577,
    "user_id": "1ejqec",
    "image_id": "asf2",
    "sub_id": "my-user-1234",
    "created_at": "2023-10-28T17:39:28.000Z"
  }

]
```

--------------------------------

### Get Random Dog Facts

Source: https://docs.thedogapi.com/ru/docs/examples/facts

Fetches a specified number of random dog facts from The Dog API. Requires an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/facts?limit=1  

```

--------------------------------

### Dog Image Response Sample

Source: https://docs.thedogapi.com/reference

Example JSON response structure for a successful retrieval of dog images. Includes image details such as ID, URL, dimensions, MIME type, and associated breed information.

```JSON
`[
  {
    "id": "S1bsCGxrf",
    "url": "http://78.media.tumblr.com/2bc94b9eec2d00f5d28110ba191da896/tumblr_nyled8DYKd1qg9kado1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [
      {
        "id": 3,
        "name": "Alaskan Malamute",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Alaskan_Malamute"
      },
      {
        "id": 2,
        "name": "Akita",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Akita_(dog)"
      }
    ],
    "animals": [ ],
    "categories": [ ]
  }
]`
```

--------------------------------

### Dog Image Response Sample

Source: https://docs.thedogapi.com/ru/reference

Example JSON response structure for a successful retrieval of dog images. Includes image details such as ID, URL, dimensions, MIME type, and associated breed information.

```JSON
`[
  {
    "id": "S1bsCGxrf",
    "url": "http://78.media.tumblr.com/2bc94b9eec2d00f5d28110ba191da896/tumblr_nyled8DYKd1qg9kado1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [
      {
        "id": 3,
        "name": "Alaskan Malamute",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Alaskan_Malamute"
      },
      {
        "id": 2,
        "name": "Akita",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Akita_(dog)"
      }
    ],
    "animals": [ ],
    "categories": [ ]
  }
]`
```

--------------------------------

### Authorize API Request with cURL

Source: https://docs.thedogapi.com/docs/authorization

This example demonstrates how to make an authorized request to The Dog API using cURL. It shows the correct way to include the API key in the 'x-api-key' header.

```bash
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds  

```

--------------------------------

### Get Dog Image Analysis

Source: https://docs.thedogapi.com/es/docs/examples/images

Provides an analysis of a specific dog image, likely including breed predictions or other metadata. Requires the image ID and an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/analysis
```

--------------------------------

### List Uploaded Dog Images with The Dog API

Source: https://docs.thedogapi.com/pt-BR/docs/examples/images

This snippet shows how to list all images that have been uploaded by the user to The Dog API. It requires an API key for authentication and uses a GET request to the images endpoint.

```cURL
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
```

--------------------------------

### Authorize API Request with cURL

Source: https://docs.thedogapi.com/es/docs/authorization

This example demonstrates how to include your API key in the 'x-api-key' header when making a request to The Dog API using cURL. Replace 'YOUR-API-KEY' with your actual API key.

```cURL
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds  
```

--------------------------------

### Get Favorite Dog Images Response Sample

Source: https://docs.thedogapi.com/ru/reference

This snippet shows a sample JSON response when retrieving a list of favorite dog images. It includes details like image ID, user ID, and creation timestamp.

```json
[
  {
    "id": 232413577,
    "user_id": "1ejqec",
    "image_id": "asf2",
    "sub_id": "my-user-1234",
    "created_at": "2023-10-28T17:39:28.000Z"
  }

]
```

--------------------------------

### List Uploaded Dog Images

Source: https://docs.thedogapi.com/ru/docs/examples/images

Lists all images uploaded by the user to The Dog API. Requires an API key for authentication.

```bash
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
```

--------------------------------

### Search Dog Images

Source: https://docs.thedogapi.com/ru/docs/examples/images

Searches for dog images using the Dog API. Requires an API key and allows specifying a limit for the number of results. Returns a list of image objects.

```bash
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
```

--------------------------------

### Get Favorite Dog Images Response Sample

Source: https://docs.thedogapi.com/de/reference

This snippet shows a sample JSON response when retrieving a list of favorite dog images. It includes details like image ID, user ID, and creation timestamp.

```json
[
  {
    "id": 232413577,
    "user_id": "1ejqec",
    "image_id": "asf2",
    "sub_id": "my-user-1234",
    "created_at": "2023-10-28T17:39:28.000Z"
  }

]
```

--------------------------------

### Get All Dog Breeds

Source: https://docs.thedogapi.com/de/reference

Retrieves a list of all available dog breeds. Supports optional pagination using 'limit' and 'page' query parameters. Requires an API key for authorization. The response is a JSON array of breed objects.

```http
GET /v1/breeds?limit=10&page=0
https://api.thedogapi.com/v1/breeds
```

--------------------------------

### Get All Dog Breeds

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves a list of all available dog breeds. Supports optional pagination using 'limit' and 'page' query parameters. Requires an API key for authorization. The response is a JSON array of breed objects.

```http
GET /v1/breeds?limit=10&page=0
https://api.thedogapi.com/v1/breeds
```

--------------------------------

### Get All Dog Breeds

Source: https://docs.thedogapi.com/ja/reference

Retrieves a list of all available dog breeds. Supports optional pagination using 'limit' and 'page' query parameters. Requires an API key for authorization. The response is a JSON array of breed objects.

```http
GET /v1/breeds?limit=10&page=0
https://api.thedogapi.com/v1/breeds
```

--------------------------------

### Upload Dog Image

Source: https://docs.thedogapi.com/ru/docs/examples/images

Uploads a dog image file to The Dog API. Requires an API key and the file to be uploaded. Uses a POST request with multipart/form-data.

```bash
curl -X POST -H "x-api-key: YOUR-API-KEY" -F "file=@/path/dog.jpg" https://api.thedogapi.com/v1/images/upload
```

--------------------------------

### Get Random Dog Facts

Source: https://docs.thedogapi.com/docs/examples/facts

Retrieves a specified number of random dog facts. Requires an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/facts?limit=1  

```

--------------------------------

### List All Dog Breeds using The Dog API

Source: https://docs.thedogapi.com/pt-BR/docs/examples/breeds

Fetches a list of all available dog breeds from The Dog API. Requires an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds  
```

--------------------------------

### List Uploaded Dog Images

Source: https://docs.thedogapi.com/de/docs/examples/images

Lists all dog images uploaded by the authenticated user. Requires an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
```

--------------------------------

### Get Specific Dog Image

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves a specific dog image by its unique ID. This endpoint works for both public images and images uploaded by the user.

```HTTP
GET https://api.thedogapi.com/v1/images/{image_id}
```

--------------------------------

### List Dog Image by ID

Source: https://docs.thedogapi.com/ru/docs/examples/images

Retrieves a specific dog image by its ID from The Dog API. Requires an API key for authentication.

```bash
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/BJa4kxc4X
```

--------------------------------

### Get Vote by ID - TheDogAPI

Source: https://docs.thedogapi.com/pt-BR/docs/examples/votes-favourites

Retrieves a specific vote entry using its unique ID. Requires the vote ID and an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/votes/VOTE_ID  
```

--------------------------------

### List Uploaded Dog Images

Source: https://docs.thedogapi.com/docs/examples/images

Lists all images uploaded by the authenticated user. Requires an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
```

--------------------------------

### Get Favourite by ID - TheDogAPI

Source: https://docs.thedogapi.com/pt-BR/docs/examples/votes-favourites

Retrieves a specific favourite entry using its unique ID. Requires the favourite ID and an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/favourites/FAVOURITE_ID  
```

--------------------------------

### Search Dog Images

Source: https://docs.thedogapi.com/ja/docs/examples/images

Searches for dog images using the API. Requires an API key and allows specifying a limit for the number of results. Returns a list of image objects.

```curl
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
```

--------------------------------

### List Uploaded Dog Images

Source: https://docs.thedogapi.com/ja/docs/examples/images

Lists all dog images that have been uploaded by the authenticated user. Requires an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
```

--------------------------------

### Get Image Breed Information

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves breed information associated with a specific image. Requires an image ID as a path parameter. The response is in JSON format.

```http
GET /v1/images/{image_id}/breeds
https://api.thedogapi.com/v1/images/{image_id}/breeds
```

--------------------------------

### Get Image Breed Information

Source: https://docs.thedogapi.com/ru/reference

Retrieves breed information associated with a specific image. Requires an image ID as a path parameter. The response is in JSON format.

```http
GET /v1/images/{image_id}/breeds
https://api.thedogapi.com/v1/images/{image_id}/breeds
```

--------------------------------

### Search Dog Images

Source: https://docs.thedogapi.com/docs/examples/images

Searches for dog images using the API. Requires an API key and allows specifying a limit for the number of results.

```curl
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
```

--------------------------------

### Search Dog Images

Source: https://docs.thedogapi.com/de/docs/examples/images

Searches for dog images using the API. Requires an API key and allows specifying a limit for the number of results.

```curl
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
```

--------------------------------

### Get Image Breed Information

Source: https://docs.thedogapi.com/reference

Retrieves breed information associated with a specific image. Requires an image ID as a path parameter. The response is in JSON format.

```http
GET /v1/images/{image_id}/breeds
https://api.thedogapi.com/v1/images/{image_id}/breeds
```

--------------------------------

### List Breeds for Dog Image

Source: https://docs.thedogapi.com/ru/docs/examples/images

Lists the breed tags associated with a specific dog image on The Dog API. Requires an API key and the image ID.

```bash
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/breeds
```

--------------------------------

### Get Image Breed Information

Source: https://docs.thedogapi.com/es/reference

Retrieves breed information associated with a specific image. Requires an image ID as a path parameter. The response is in JSON format.

```http
GET /v1/images/{image_id}/breeds
https://api.thedogapi.com/v1/images/{image_id}/breeds
```

--------------------------------

### Get Dog Images with Query Parameters

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves dog images from TheDogAPI. Supports optional query parameters such as 'limit' for the number of images, 'page' for pagination (requires account_id), and 'order' for sorting (requires account_id). Requires an 'x-api-key' header for authorization.

```http
GET /v1/images?limit=10&page=0&order=DESC
Host: https://api.thedogapi.com
Content-Type: application/json
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Image Breed Information

Source: https://docs.thedogapi.com/de/reference

Retrieves breed information associated with a specific image. Requires an image ID as a path parameter. The response is in JSON format.

```http
GET /v1/images/{image_id}/breeds
https://api.thedogapi.com/v1/images/{image_id}/breeds
```

--------------------------------

### Dog Image Response Sample

Source: https://docs.thedogapi.com/de/reference

A sample JSON response for the /images endpoint, containing details about dog images including ID, URL, dimensions, MIME type, associated breeds, and other metadata.

```json
`[
  {
    "id": "S1bsCGxrf",
    "url": "http://78.media.tumblr.com/2bc94b9eec2d00f5d28110ba191da896/tumblr_nyled8DYKd1qg9kado1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [
      {
        "id": 3,
        "name": "Alaskan Malamute",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Alaskan_Malamute"
      },
      {
        "id": 2,
        "name": "Akita",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Akita_(dog)"
      }
    ],
    "animals": [ ],
    "categories": [ ]
  },
  {
    "id": "B1gZsCMgrG",
    "url": "http://78.media.tumblr.com/75f7f5ba97da53c61026fe6cad16c97c/tumblr_o8h7llrbDt1rzz2who1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [ ],
    "animals": [ ],
    "categories": [ ]
}
]
`
```

--------------------------------

### Get Image Breed Information

Source: https://docs.thedogapi.com/ja/reference

Retrieves breed information associated with a specific image. Requires an image ID as a path parameter. The response is in JSON format.

```http
GET /v1/images/{image_id}/breeds
https://api.thedogapi.com/v1/images/{image_id}/breeds
```

--------------------------------

### Dog Image Response Sample

Source: https://docs.thedogapi.com/ja/reference

A sample JSON response for the /images endpoint, containing details about dog images including ID, URL, dimensions, MIME type, associated breeds, and other metadata.

```json
`[
  {
    "id": "S1bsCGxrf",
    "url": "http://78.media.tumblr.com/2bc94b9eec2d00f5d28110ba191da896/tumblr_nyled8DYKd1qg9kado1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [
      {
        "id": 3,
        "name": "Alaskan Malamute",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Alaskan_Malamute"
      },
      {
        "id": 2,
        "name": "Akita",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Akita_(dog)"
      }
    ],
    "animals": [ ],
    "categories": [ ]
  },
  {
    "id": "B1gZsCMgrG",
    "url": "http://78.media.tumblr.com/75f7f5ba97da53c61026fe6cad16c97c/tumblr_o8h7llrbDt1rzz2who1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [ ],
    "animals": [ ],
    "categories": [ ]
}
]
`
```

--------------------------------

### Get Dog Facts by Breed

Source: https://docs.thedogapi.com/ru/docs/examples/facts

Retrieves dog facts associated with a specific breed ID. You need to provide the breed ID and an API key.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds/BREED_ID/facts?limit=5  

```

--------------------------------

### Dog Image Response Sample

Source: https://docs.thedogapi.com/es/reference

A sample JSON response for the /images endpoint, containing details about dog images including ID, URL, dimensions, MIME type, associated breeds, and other metadata.

```json
`[
  {
    "id": "S1bsCGxrf",
    "url": "http://78.media.tumblr.com/2bc94b9eec2d00f5d28110ba191da896/tumblr_nyled8DYKd1qg9kado1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [
      {
        "id": 3,
        "name": "Alaskan Malamute",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Alaskan_Malamute"
      },
      {
        "id": 2,
        "name": "Akita",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Akita_(dog)"
      }
    ],
    "animals": [ ],
    "categories": [ ]
  },
  {
    "id": "B1gZsCMgrG",
    "url": "http://78.media.tumblr.com/75f7f5ba97da53c61026fe6cad16c97c/tumblr_o8h7llrbDt1rzz2who1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [ ],
    "animals": [ ],
    "categories": [ ]
}
]
`
```

--------------------------------

### Get Specific Breed Details

Source: https://docs.thedogapi.com/es/docs/examples/breeds

Fetches detailed information for a specific dog breed using its unique ID. An API key is necessary for this request.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds/BREED_ID
```

--------------------------------

### Search Dog Images

Source: https://docs.thedogapi.com/es/docs/examples/images

Retrieves a list of dog images from the API. You can specify a limit for the number of results. Requires an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
```

--------------------------------

### Get Dog Facts for a Specific Breed

Source: https://docs.thedogapi.com/docs/examples/facts

Retrieves a specified number of dog facts for a particular breed, identified by its BREED_ID. An API key is required.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds/BREED_ID/facts?limit=5  

```

--------------------------------

### List Uploaded Dog Images

Source: https://docs.thedogapi.com/es/docs/examples/images

Retrieves a list of all images that have been uploaded by the authenticated user. An API key is necessary.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images
```

--------------------------------

### Dog Image Response Sample

Source: https://docs.thedogapi.com/pt-BR/reference

A sample JSON response for the /images endpoint, containing details about dog images including ID, URL, dimensions, MIME type, associated breeds, and other metadata.

```json
`[
  {
    "id": "S1bsCGxrf",
    "url": "http://78.media.tumblr.com/2bc94b9eec2d00f5d28110ba191da896/tumblr_nyled8DYKd1qg9kado1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [
      {
        "id": 3,
        "name": "Alaskan Malamute",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Alaskan_Malamute"
      },
      {
        "id": 2,
        "name": "Akita",
        "wikipedia_url": "https://en.wikipedia.org/wiki/Akita_(dog)"
      }
    ],
    "animals": [ ],
    "categories": [ ]
  },
  {
    "id": "B1gZsCMgrG",
    "url": "http://78.media.tumblr.com/75f7f5ba97da53c61026fe6cad16c97c/tumblr_o8h7llrbDt1rzz2who1_1280.jpg",
    "width": null,
    "height": null,
    "mime_type": "image/jpeg",
    "entities": [ ],
    "breeds": [ ],
    "animals": [ ],
    "categories": [ ]
}
]
`
```

--------------------------------

### List All Dog Breeds

Source: https://docs.thedogapi.com/es/docs/examples/breeds

Retrieves a list of all available dog breeds from The Dog API. Requires an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds
```

--------------------------------

### Upload Dog Image

Source: https://docs.thedogapi.com/docs/examples/images

Uploads a dog image file to the API. Requires an API key and the file path to the image.

```curl
curl -X POST -H "x-api-key: YOUR-API-KEY" -F "file=@/path/dog.jpg" https://api.thedogapi.com/v1/images/upload
```

--------------------------------

### Get Specific Dog Image

Source: https://docs.thedogapi.com/ja/reference

Retrieves a specific dog image using its unique ID. This endpoint works for both public images and user-uploaded images. Requires authorization.

```HTTP
GET /v1/images/{image_id}

---

**Path Parameters:**
image_id: string (required) - The ID of the image to retrieve

**Responses:**
200 OK
404 Image not found
```

--------------------------------

### Get Vote by ID - The Dog API

Source: https://docs.thedogapi.com/docs/examples/votes-favourites

Retrieves details of a specific vote using its unique ID. Requires the vote ID and your API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/votes/VOTE_ID  
```

--------------------------------

### Get Dog Images with Parameters

Source: https://docs.thedogapi.com/reference

Retrieves dog images from TheDogAPI. Supports optional query parameters like 'limit' for the number of images, 'page' for pagination (requires account_id), and 'order' for sorting results (ASC/DESC, requires account_id). An 'x-api-key' header is required for authentication.

```HTTP
GET /v1/images?limit=10&order=DESC
Host: https://api.thedogapi.com
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Vote by ID - The Dog API

Source: https://docs.thedogapi.com/es/docs/examples/votes-favourites

Retrieves a specific vote using its unique vote ID. Requires the vote ID and your API key for authentication.

```cURL
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/votes/VOTE_ID  
```

--------------------------------

### Get Dog Images with Query Parameters

Source: https://docs.thedogapi.com/ja/reference

Retrieves dog images from TheDogAPI. Supports optional query parameters such as 'limit' for the number of images, 'page' for pagination (requires account_id), and 'order' for sorting (requires account_id). Requires an 'x-api-key' header for authorization.

```http
GET /v1/images?limit=10&page=0&order=DESC
Host: https://api.thedogapi.com
Content-Type: application/json
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Specific Breed Details

Source: https://docs.thedogapi.com/docs/examples/breeds

Fetches detailed information for a specific dog breed using its unique identifier (BREED_ID). An API key is necessary for this operation.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds/BREED_ID  
```

--------------------------------

### Get Dog Images with Parameters

Source: https://docs.thedogapi.com/ru/reference

Retrieves dog images from TheDogAPI. Supports optional query parameters like 'limit' for the number of images, 'page' for pagination (requires account_id), and 'order' for sorting results (ASC/DESC, requires account_id). An 'x-api-key' header is required for authentication.

```HTTP
GET /v1/images?limit=10&order=DESC
Host: https://api.thedogapi.com
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Favorite Images

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves all favorite images saved by the user. Requires an API key in the 'x-api-key' header for authorization. The response is a JSON array of favorite image objects.

```http
GET /v1/favourites
https://api.thedogapi.com/v1/favourites
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Image by ID

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves details for a specific image using its ID. This endpoint can also be used to delete images that have been uploaded by the user. Requires an API key for authorization.

```json
{
  "id": "6euYVVE_u",
  "url": "https://cdn2.thedogapi.com/images/6euYVVE_u.jpg",
  "width": 1024,
  "height": 685,
  "breeds": [
    {
      "weight": {
        "imperial": "23 - 28",
        "metric": "10 - 13"
},
      "height": {
        "imperial": "15.5 - 20",
        "metric": "39 - 51"
},
      "id": 111,
      "name": "Finnish Spitz",
      "bred_for": "Hunting birds, small mammals",
      "breed_group": "Non-Sporting",
      "life_span": "12 - 15 years",
      "temperament": "Playful, Loyal, Independent, Intelligent, Happy, Vocal",
      "reference_image_id": "3PjHlQbkV"
}
]

}
```

--------------------------------

### Get Dog Images with Query Parameters

Source: https://docs.thedogapi.com/de/reference

Retrieves dog images from TheDogAPI. Supports optional query parameters such as 'limit' for the number of images, 'page' for pagination (requires account_id), and 'order' for sorting (requires account_id). Requires an 'x-api-key' header for authorization.

```http
GET /v1/images?limit=10&page=0&order=DESC
Host: https://api.thedogapi.com
Content-Type: application/json
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Dog Images with Query Parameters

Source: https://docs.thedogapi.com/es/reference

Retrieves dog images from TheDogAPI. Supports optional query parameters such as 'limit' for the number of images, 'page' for pagination (requires account_id), and 'order' for sorting (requires account_id). Requires an 'x-api-key' header for authorization.

```http
GET /v1/images?limit=10&page=0&order=DESC
Host: https://api.thedogapi.com
Content-Type: application/json
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Favorite Images

Source: https://docs.thedogapi.com/de/reference

Retrieves all favorite images saved by the user. Requires an API key in the 'x-api-key' header for authorization. The response is a JSON array of favorite image objects.

```http
GET /v1/favourites
https://api.thedogapi.com/v1/favourites
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Get Favorite Images

Source: https://docs.thedogapi.com/ja/reference

Retrieves all favorite images saved by the user. Requires an API key in the 'x-api-key' header for authorization. The response is a JSON array of favorite image objects.

```http
GET /v1/favourites
https://api.thedogapi.com/v1/favourites
x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### Search Dog Images

Source: https://docs.thedogapi.com/reference

Searches for dog images based on various parameters like size, mime types, breed data, and order. Supports pagination with API key. Requires an API key for full functionality.

```HTTP
GET https://api.thedogapi.com/v1/images/search?size=med&mime_types=jpg,png&has_breeds=true&order=ASC&page=0&limit=10

Headers:
  x-api-key: {{YOUR-API-KEY}}
```

--------------------------------

### List All Dog Breeds

Source: https://docs.thedogapi.com/docs/examples/breeds

Retrieves a list of all available dog breeds from The Dog API. Requires an API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/breeds  
```

--------------------------------

### Upload Dog Image

Source: https://docs.thedogapi.com/ja/docs/examples/images

Uploads a dog image file to the API. Requires an API key and the image file specified with the '-F' flag. The file path should be adjusted accordingly.

```curl
curl -X POST -H "x-api-key: YOUR-API-KEY" -F "file=@/path/dog.jpg" https://api.thedogapi.com/v1/images/upload
```

--------------------------------

### Get Favourite by ID - The Dog API

Source: https://docs.thedogapi.com/docs/examples/votes-favourites

Retrieves details of a specific favourite entry using its unique ID. Requires the favourite ID and your API key for authentication.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/favourites/FAVOURITE_ID  
```

--------------------------------

### Get Favourite by ID - The Dog API

Source: https://docs.thedogapi.com/es/docs/examples/votes-favourites

Retrieves a specific favourite image using its unique favourite ID. Requires the favourite ID and your API key for authentication.

```cURL
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/favourites/FAVOURITE_ID  
```

--------------------------------

### Get Random Dog Facts

Source: https://docs.thedogapi.com/pt-BR/reference

Retrieves one or more random facts about dog breeds. The number of facts returned can be controlled by the 'limit' parameter. This endpoint is authorized using an API key.

```json
[
  {
    "id": "MBM2F",
    "fact": "Finnish Spitz dogs are known for their distinctive bark, which they use to alert hunters to the location of game birds in trees.",
    "breed_id": 111,
    "title": "Hunting Bark"
  }
]
```

--------------------------------

### Get Random Dog Facts

Source: https://docs.thedogapi.com/ru/reference

Retrieves one or more random facts about dog breeds. The number of facts returned can be controlled by the 'limit' parameter. This endpoint is authorized using an API key.

```json
[
  {
    "id": "MBM2F",
    "fact": "Finnish Spitz dogs are known for their distinctive bark, which they use to alert hunters to the location of game birds in trees.",
    "breed_id": 111,
    "title": "Hunting Bark"
  }
]
```

--------------------------------

### Search Dog Images with The Dog API

Source: https://docs.thedogapi.com/pt-BR/docs/examples/images

This snippet demonstrates how to search for dog images using The Dog API. It requires an API key and allows specifying a limit for the number of results. The response is a JSON array of image objects.

```cURL
curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/images/search?limit=2"
```

--------------------------------

### Get Favorite Images

Source: https://docs.thedogapi.com/ru/reference

Retrieves all favorite images saved by the user. This endpoint requires an API key in the 'x-api-key' header for authorization. The response is a JSON array of favorite image objects.

```http
GET /v1/favourites
https://api.thedogapi.com/v1/favourites
```

--------------------------------

### List Breeds for Dog Image

Source: https://docs.thedogapi.com/docs/examples/images

Lists all breed tags associated with a specific dog image. Requires an API key and the image ID.

```curl
curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/images/IMAGE_ID/breeds
```
Tokens:
Raw