staqlydocs
REST APIAPI referenceMedia

Stock photos from Unsplash for the design editor

Stock photos from Unsplash for the design editor (media:read)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

GET
/v1/stock/photos

Searches Unsplash on the server's key (UNSPLASH_ACCESS_KEY); without a query, its editorial feed. Without a key, configured is false and data is empty. Pictures load straight from Unsplash's CDN; credit the author with author_url and page_url.

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Query Parameters

query?string
Lengthlength <= 100
page?integer
Range1 <= value <= 100

Response Body

Photos, 30 a page

application/json
  1. response
configured*boolean

Whether this server has an Unsplash key

data*array<>
Example Request
curl -X GET 'https://staqly.example.com/v1/stock/photos'
Example Response
{  "configured": true,  "data": [    {      "id": "string",      "width": 0,      "height": 0,      "alt": "string",      "thumb": "string",      "url": "string",      "author": "string",      "author_url": "string",      "page_url": "string"    }  ]}