Developer docs

Search stock media

MCP tool
search_stock
CLI
kinetune stock search
GET
/api/v1/stock

Try it with your own API key: it runs on that key's workspace, so a real key reads your real songs, videos and credits. Reads and quotes only; nothing is charged.

Find stock photos or clips to use as a background

24 results a page. Pass an item's id as look.background.stock_id (source "stock-photo" or "stock-video") or as a Canvas's stock_id to use it instead of the director's pick, and credit the photographer (credit) wherever you show it. orientation: portrait for 9:16 and 1:1, landscape when 16:9 is among the formats (a Canvas is portrait). Clips too short for the loop are left out: pass seconds for a Canvas. thumbnail_url is a 480 px still, preview_url a 1280 px one (the photo, or the clip's poster), preview_video_url a small MP4 of a clip.

Authorization

headerAuthorizationBearer <token>

An organization API key (kt_live_…) or an OAuth access token

Query Parameters

kind*string

photo for stock-photo, video for stock-video

Value in"photo""video"
q*string

Search words, e.g. "foggy pine forest"

Length1 <= length <= 100
orientation?string

Default portrait

Value in"portrait""landscape"
page?integer

Default 1; next_page says whether there are more

Range1 <= value <= 50
seconds?integer

Clips for a Canvas of this length (5–8); omit for a Look's loop

Range5 <= value <= 8

Response Body

OK

Example Request
curl -X GET 'https://kinetune.com/api/v1/stock?kind=photo&q=string'
Example Response
Empty