place.dog
App · Images & Design · 3 actions
Placeholder photographs of dogs, at any size you ask for, for mock-ups, email templates and test data. Free and keyless.
Actions
| Action | What it does |
|---|---|
| Check service status | Check whether place.dog is answering, and how quickly, without failing the step when it is not. |
| Get a dog photo | Get a placeholder photograph of a dog at a size you choose, as an address to drop into a mock-up or as a file to keep. |
| Get several dog photos | Get several placeholder addresses at once, for a gallery or a mock-up grid. |
Check service status
Check whether place.dog is answering, and how quickly, without failing the step when it is not. Asks for the smallest image there is, so it costs almost nothing. Branch on 'ok' before building a page of placeholders that will not load. No API key required.
Inputs
None.
Outputs
latency_msnumbermessagetextoktrue/falseserves_declared_content_typetrue/falsestatus_codenumber
Example output
{
"latency_ms": 298.0,
"message": null,
"ok": true,
"serves_declared_content_type": false,
"status_code": 200
}Get a dog photo
Get a placeholder photograph of a dog at a size you choose, as an address to drop into a mock-up or as a file to keep. Leave 'Save as a file' off and the step costs no request at all. No API key required.
Inputs
- Width
widthnumber - How wide the photograph should be, in pixels, from 1 to 3000. Defaults to 640. place.dog refuses anything outside that range, so it is checked here before the request.From 1 to 3000.
- Height
heightnumber - How tall the photograph should be, in pixels, from 1 to 3000. Defaults to 480. Both dimensions are required by the service: a width on its own is a 404.From 1 to 3000.
- Save as a file
save_as_filetrue/false - Download the photograph and keep it as a file. Leave this off and the step costs no request at all: it hands back the address, which is all a mock-up or an email template needs. Turn it on when the image has to survive the page it was put on, or when the same dog has to appear twice: place.dog offers no id or seed, so the same address is a different dog every time it loads.
Outputs
document_reftextdocumentslistfile_urltextphotoobjectsavedtrue/falsesaved_as_filetrue/falsesize_bytesnumber
Example output
{
"document_ref": "",
"documents": [],
"file_url": "",
"photo": {
"content_type": null,
"declared_content_type": null,
"filename": null,
"height": 480,
"type_was_misdeclared": false,
"url": "https://place.dog/640/480",
"width": 640
},
"saved": false,
"saved_as_file": false,
"size_bytes": 0
}Get several dog photos
Get several placeholder addresses at once, for a gallery or a mock-up grid. Addresses only, so this costs no requests: the browser fetches them when the page loads, and each one is a different dog. No API key required.
Inputs
- How many
countnumber - How many addresses to hand back, from 1 to 20. Defaults to 3.From 1 to 20.
- Width
widthnumber - How wide the photograph should be, in pixels, from 1 to 3000. Defaults to 640. place.dog refuses anything outside that range, so it is checked here before the request.From 1 to 3000.
- Height
heightnumber - How tall the photograph should be, in pixels, from 1 to 3000. Defaults to 480. Both dimensions are required by the service: a width on its own is a 404.From 1 to 3000.
Outputs
addresses_are_identicaltrue/falseheightnumberphoto_countnumberphotoslistwidthnumber
Example output
{
"addresses_are_identical": true,
"height": 480,
"photo_count": 2,
"photos": [
{
"content_type": null,
"declared_content_type": null,
"filename": null,
"height": 480,
"type_was_misdeclared": false,
"url": "https://place.dog/640/480",
"width": 640
},
{
"content_type": null,
"declared_content_type": null,
"filename": null,
"height": 480,
"type_was_misdeclared": false,
"url": "https://place.dog/640/480",
"width": 640
}
],
"width": 640
}