KuikCodeDocs
APIReferenceImages

Search stock photos

GET
/stock/photos

Free Pexels photos (commercial use, no attribution needed). An empty query returns a curated selection. Import one with POST /stock/photos/{id}/import before using it on a page.

Authorization

apiKey
AuthorizationBearer <token>

An API key from Settings, Developers: Authorization: Bearer kc_live_...

In: header

Query Parameters

q?string
Lengthlength <= 80
Default""
page?integer
Range1 <= value <= 50
Default1
perPage?integer
Range1 <= value <= 30
Default12

Response Body

application/json

curl -X GET "https://example.com/stock/photos"
{  "data": [    {      "id": 0,      "thumb": "string",      "photographer": "string",      "alt": "string",      "width": 0,      "height": 0    }  ]}

Add an image POST

Stores an image in the workspace Library, from a public https URL or as base64, and returns its CDN URL for KuikPage blocks. PNG, JPEG, WebP or SVG; raster images are re-encoded to WebP and capped at 2400 px on the long edge.

Import a stock photo POST

Copies a Pexels photo into the workspace Library at up to 1280 px wide and returns its CDN URL.