Assets

List or search assets

Returns ready assets newest first as compact rows (description, category, dimensions, url, srcSet); fetch one asset for originalUrl and variants. Filter by kind, category, type (the broad MIME family: image, video, audio, font, or document), or search, which prefix-matches each term against the filename, description, and category; every term must match, else any term. Page size defaults to 50 (max 100).

get/websiteAssets

Request

  • Base URL: https://api.cactal.ai/v1
  • URL: https://api.cactal.ai/v1/websiteAssets
  • Auth: HTTP bearer

Query parameters

websiteIdstring required
kind'image' | 'file'
category'logo' | 'icon' | 'photo' | 'illustration' | 'screenshot' | 'graphic' | 'background' | 'other'

Only images with this category.

type'image' | 'video' | 'audio' | 'font' | 'document'

Broad file type derived from the MIME type: image, video, audio, font, or document (everything else). Combines with kind, category, and search.

searchstring

Matches filename, description, and category; each term matches as a prefix.

cursorstring
limitinteger

Response

One page of ready assets, newest first.

nextCursorstring nullable required

Opaque cursor for the next page. Pass it as the cursor parameter on the next request. null when this is the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.