Skip to main content
POST
search stock

Authorizations

Authorization
string
header
required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key
string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id
string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json
query
string
required

Plain words: "city at night", "hands typing"; one or two find more than a sentence. Music also ranks a phrase by meaning: "hopeful piano under a voice".

Maximum string length: 100
kind
enum<string>

image (default), illustration, vector (flat art and icons as pictures), video, music, sfx, or ambience. Sound is Eversince's own and needs no attribution; pictures and video come from the free shelves.

Available options:
image,
illustration,
vector,
video,
music,
sfx,
ambience
orientation
enum<string>

The shape of the piece it is for; a vertical cut takes portrait.

Available options:
landscape,
portrait,
square
page
integer

next_page from the answer before, same search and limit.

Required range: 1 <= x <= 50
limit
integer

Up to 60. Default 8 sounds, 12 pictures or videos.

Required range: 1 <= x <= 60
kept
boolean

Sound only: only the sounds this workspace has starred in the app.

min_seconds
number

Sound only: no shorter than this many seconds.

Required range: x >= 0
max_seconds
number

Sound only: no longer than this.

Required range: x >= 0
bpm_min
number

Music only: the slowest tempo that fits the cut.

Required range: 20 <= x <= 300
bpm_max
number

Music only: the fastest tempo that fits the cut.

Required range: 20 <= x <= 300
vocals
boolean

Music only: true for singing, false for none.

mood
enum<string>[]

Music only: tracks carrying any of these moods.

Maximum array length: 4
Available options:
hopeful,
calm,
warm,
playful,
energetic,
epic,
tense,
dark,
sad
energy
enum<string>

Music only: steady holds one level; builds rises to a peak.

Available options:
steady,
builds,
drops,
varies
under_voice
boolean

Music only: true for tracks speech stays clear over.

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

ok
any
required
data
object
required
meta
object
required
media
object[]