Search stock media

GEThttps://api.vidmoat.com/v1/stock/search

Bearer tokenScope stock.readFreeTry it in the playground

Search the stock library by keyword, then import a result's downloadUrl with /v1/media/import.

Query parameters#

querystring
Keywords. Required for video and image; for audio, empty returns a popular list.
typeenumdefault video
What to search.
One of video, image, audio
limitintegerdefault 12
1 to 24.

Response#

Returns 200.

Response fields#

dataarray
Results. Video and image results have provider, id, mediaType, thumbnailUrl, downloadUrl, width, height, duration (video), photographer, sourceUrl and licence fields. Audio results (CC0 only) have id, name, downloadUrl, duration, username, sourceUrl, tags and bpm.
hintstring
What to do with a result.

Errors#

Besides the errors any request can get (authentication, rate limits):

Status	Code	When
400	`invalid_request`	`query` is missing for a video or image search.
502	`provider_error`	The search failed.

curl

curl "https://api.vidmoat.com/v1/stock/search?query=city+at+night&type=video" \
  -H "Authorization: Bearer $VIDMOAT_KEY"

Response 200

{
  "data": [{
    "provider": "pexels",
    "id": "123",
    "mediaType": "video",
    "thumbnailUrl": "https://…",
    "downloadUrl": "https://…",
    "width": 1920, "height": 1080, "duration": 12,
    "photographer": "Jane Doe",
    "sourceUrl": "https://www.pexels.com/…"
  }],
  "hint": "Pass a result's downloadUrl to POST /v1/media/import, then use the url that returns as an addClip `src`."
}