resources

Search stock media (Pexels / Pixabay / Freesound / Klipy)

Search licensed stock media by keyword. Pass query for one search, or queries[] (≤10) to run a batch in ONE call — the batch returns results[], one entry per query in order, each with its own candidates (and an error string if that single query failed; one bad query never discards the rest). kind selects the corpus (video/photo default to Pexels; Pixabay is explicitly selectable; sfx → Freesound CC0-only; gif → Klipy); defaults to video. Returns ranked candidates each carrying an opaque candidateId — pass it to import_resource to bring the asset into a project. Free + rate-limited; results are cached for 7 days, after which a candidateId must be refreshed by searching again. For sfx, bound the result by clip length with durationSec — impacts/ticks ≈ 0–2s, risers/whooshes ≈ 2–8s, ambients unbounded. For video, use minWidth/minHeight to exclude smaller renditions.

post/v1/resources/search

Request

  • Base URL: https://api.cueframe.ai
  • URL: https://api.cueframe.ai/v1/resources/search
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.cueframe.ai/api/auth/mcp/authorize, token URL https://api.cueframe.ai/api/auth/mcp/token, scopes: media:read)
    • API key in header PAYMENT-SIGNATURE

Request body

querystring
queriesstring[]
kind'video' | 'photo' | 'sfx' | 'gif'
provider'pexels' | 'pixabay' | 'freesound' | 'klipy'
limitinteger
minWidthinteger

Video-only minimum selected-rendition width in pixels; smaller results are excluded.

minHeightinteger

Video-only minimum selected-rendition height in pixels; smaller results are excluded.

Response

Ranked stock candidates.

provider'pexels' | 'pixabay' | 'freesound' | 'klipy'
kind'video' | 'photo' | 'sfx' | 'gif'

Changes

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