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 key's own.

Body

application/json
query
string
required

Plain words: "city at night", "hands typing". One or two words find more than a sentence.

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

The next page of the same search. Each page is up to 60.

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

Up to 60.

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.

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[]