Video Upload
Upload videos for a review.
Only API keys on our Conversations platform are eligible to use this API version. Refer to the Platforms section of our Platform & API Concepts documentation to learn which platform your API keys are on.
This example is applicable only for full submission.
Try out Video Upload API reference here .
Examples
The following examples demonstrate common video upload requests. For a complete overview of video uploads, refer to the Video Upload tutorial.
Upload a video from a file
Videos must be uploaded using HTTP POST.
Staging
POST /data/uploadvideo.json?ApiVersion=[latestApiVersion]&ContentType=[review]&PassKey=[API_key] HTTP/1.1
Host: stgmedia.api.bazaarvoice.com
Content-Length: 71374
Content-Type: multipart/form-data; boundary=----FormBoundarycSTk3Rd73AEuhGuD
...
\----FormBoundaryE19zNvXGzXaLvS5C
Content-Disposition: form-data; name="video"; filename="your_video.mpeg"
\---FormBoundaryE19zNvXGzXaLvS5C
Production
POST /data/uploadvideo.json?ApiVersion=[latestApiVersion]&ContentType=[review]&PassKey=[API_key] HTTP/1.1
Host: media.api.bazaarvoice.com
Content-Length: 71374
Content-Type: multipart/form-data; boundary=----FormBoundarycSTk3Rd73AEuhGuD
...
\----FormBoundaryE19zNvXGzXaLvS5C
Content-Disposition: form-data; name="video"; filename="your_video.mpeg"
\---FormBoundaryE19zNvXGzXaLvS5C
Ellipses (...) in above example indicate that your app may generate other headers.
Parameters
Name | Description |
---|---|
[FORMAT] | Response format (json). 📝 Required This field is required in all API requests. |
ApiVersion | The API version, e.g. 5.4. 📝 Required This field is required in all API requests. |
ContentType | The content type for which this media is being submitted. Valid values include: review. 📝 Required This field is required in all API requests. |
Locale | Locale to display Labels, Configuration, Product Attributes and Category Attributes in. The default value is the locale defined in the display associated with the API key. 🔺 Alert Failure to submit this field will result in your content being ineligible for syndication, authenticity or other business processes. |
PassKey | API key is required to authenticate API user and check permission to access particular client's data. 📝 Required This field is required in all API requests. |
Video | A file representing the video to be submitted. Note that the parameter name is case-sensitive and must be lowercase. Use video parameter to define the video to upload. ⚠️ Caution This field may be required depending on per client configurations. |
Response format
The following is an example of a video upload response:
{
"Locale": "en_US",
"Errors": [],
"Form": [
{
"Type": "Field",
"Id": "video"
}
],
"Video": {
"VideoId": "861f7833-1ef4-43a9-a214-43b8d06381ab",
"VideoHost": "BAZAARVOICE",
"VideoThumbnailUrl": "https://d2pg9tvqg9rw5b.cloudfront.net/861f7833-1ef4-43a9-a214-43b8d06381ab/thumbnail/image-00001.png",
"VideoUrl": "https://d2pg9tvqg9rw5b.cloudfront.net/861f7833-1ef4-43a9-a214-43b8d06381ab/video/movie.mp4"
},
"FormErrors": {},
"SubmissionId": null,
"Data": {
"Fields": {
"video": {
"Options": [],
"Type": "FileInput",
"Required": null,
"Label": null,
"Value": null,
"MinLength": null,
"Id": "video",
"MaxLength": null,
"Default": null
}
},
"Groups": {},
"FieldsOrder": [
"video"
],
"GroupsOrder": []
},
"TypicalHoursToPost": null,
"AuthorSubmissionToken": null,
"HasErrors": false
}
Error codes
Value | Description |
---|---|
ERROR_FORBIDDEN
|
Your configuration is disabled to collect videos. Go to configuration Hub to enable if you wish to collect videos in the review. |
VIDEO_PARSE_ERROR
|
The uploaded video could not be parsed. Ensure the video is a valid GP/3G2, ASF, AVI, DV, FLV, MOV, MP4/F4V, MPEG/MPG, QT, or WMV file. |
VIDEO_TOO_LARGE
|
The video could not be uploaded due to its size. Video must be less than 200 MB. |
ERROR_BAD_REQUEST
|
Invalid parameter in content submission. |
Updated 3 months ago