### 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/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/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/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 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}} ``` -------------------------------- ### 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}} ``` -------------------------------- ### 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/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}} ``` -------------------------------- ### 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 ```