Advertising service

Upload a video to an ad

POST /advertising/v1.0/ads/{adId}/videos/
Token

Endpoint for uploading videos. The request timeout is 10 minutes. The "Content-Type" header must be "multipart/form-data". The "Content-Length" header must contain the file size in bytes. Due to the limitations of our cloud provider, the maximum file size is 32 MB. Accepted formats are: 4xm, IFF, ISS, MTV, RoQ, aac, ac3, aea, aiff, alaw, alsa, amr, anm, apc, ape, asf, ass, au, avi, avs, bethsoftvid, bfi, bink, c93, caf, cavsvideo, cdg, daud, dirac, dnxhd, dsicin, dts, dv, dv1394, dxa, ea, ea_cdata, eac3, f32be, f32le, f64be, f64le, ffm, film_cpk, filmstrip, flac, flic, flv, gsm, gxf, h261, h263, h264, idcin, image2, image2pipe, ingenient, ipmovie, iv8, lmlm4, m4v, matroska, mjpeg, mlp, mm, mmf, mov, mp4, m4a, 3gp, 3g2, mj2, mp3, mpc, mpc8, mpeg, mpegts, mpegtsraw, mpegvideo, msnwctcp, mulaw, mvi, mxf, nc, nsv, nut, nuv, ogg, oma, oss, psxstr, pva, qcp, r3d, rawvideo, rl2, rm, rpl, rtsp, s16be, s16le, s24be, s24le, s32be, s32le, s8, sdp, shn, siff, smk, sol, sox, swf, thp, tiertexseq, tmv, truehd, tta, txd, u16be, u16le, u24be, u24le, u32be, u32le, u8, vc1, vc1test, video4linux, video4linux2, vmd, voc, vqf, w64, wav, wc3movie, wsaud, wsvqa, wv, xa, yop, yuv4mpegpipe.

Path parameters

  • adId string Required

    Id of an advertisement. It is either id that was provided in the response of the insert endpoint or it can be thirdPartyId, if it has been provided in the request body of the advertisement insert endpoint.

Query parameters

  • thirdPartyId string

    Optional custom id that can later be used instead of normal id in insert, update, delete etc. endpoints

  • order number(float)

    When displayed publicly, videos will be sorted by the "order" value in ascending order

multipart/form-data

Body

Accepted formats are: 4xm, IFF, ISS, MTV, RoQ, aac, ac3, aea, aiff, alaw, alsa, amr, anm, apc, ape, asf, ass, au, avi, avs, bethsoftvid, bfi, bink, c93, caf, cavsvideo, cdg, daud, dirac, dnxhd, dsicin, dts, dv, dv1394, dxa, ea, ea_cdata, eac3, f32be, f32le, f64be, f64le, ffm, film_cpk, filmstrip, flac, flic, flv, gsm, gxf, h261, h263, h264, idcin, image2, image2pipe, ingenient, ipmovie, iv8, lmlm4, m4v, matroska, mjpeg, mlp, mm, mmf, mov, mp4, m4a, 3gp, 3g2, mj2, mp3, mpc, mpc8, mpeg, mpegts, mpegtsraw, mpegvideo, msnwctcp, mulaw, mvi, mxf, nc, nsv, nut, nuv, ogg, oma, oss, psxstr, pva, qcp, r3d, rawvideo, rl2, rm, rpl, rtsp, s16be, s16le, s24be, s24le, s32be, s32le, s8, sdp, shn, siff, smk, sol, sox, swf, thp, tiertexseq, tmv, truehd, tta, txd, u16be, u16le, u24be, u24le, u32be, u32le, u8, vc1, vc1test, video4linux, video4linux2, vmd, voc, vqf, w64, wav, wc3movie, wsaud, wsvqa, wv, xa, yop, yuv4mpegpipe.

  • file string(binary)

Responses

  • 200 application/json

    Image successfully uploaded

    Hide response attributes Show response attributes object
    • success boolean Required
    • data object Required

      Additional properties are NOT allowed.

      Hide data attributes Show data attributes object
      • id string Required
      • url string Required
      • order number(float)
      • createdAt string(date-time) Required
POST /advertising/v1.0/ads/{adId}/videos/ 
curl \
 --request POST 'http://apis.public-staging.reas.cz/advertising/v1.0/ads/63d9007e66fc41b2cd1057c6/videos/' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: multipart/form-data" \
 --form "file=@file"
Response examples (200) 
{
  "success": true,
  "data": {
    "id": "string",
    "url": "string",
    "order": 42.0,
    "createdAt": "2025-05-04T09:42:00Z"
  }
}