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 about 1 month ago