Get latest captions
Downloads latest caption file
URL: POST /api/v1/assets/video/cc/latest
Request Parameters
| Parameter | Description | Type | Required | Possible Values |
|---|---|---|---|---|
advertiserId | The ID of the specific advertiser. | integer | Y | A valid advertiser ID |
assetId | The ID of the video asset. | string (UUID) | Y | A valid asset ID |
Sample Request
curl -X POST \ 'https://developer.api.us.stg.walmart.com/api-proxy/service/display/api/v1/api/v1/assets/video/cc/latest' \ --header 'Content-Type: multipart/form-data' \ --header 'Authorization: Bearer <auth_token>' \ --header 'WM_SEC.AUTH_SIGNATURE: **************' \ --header 'WM_SEC.KEY_VERSION: 1' \ --header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff' \ --header 'WM_CONSUMER.INTIMESTAMP: 1565309779' \ --data '{ "advertiserId": 00000000, "assetId": "00000000" }'
Response
| Element | Description | Type |
|---|---|---|
type | Specifies the type of captioning resource; typically "CLOSED_CAPTIONS". | string |
assetId | Unique identifier of the associated media asset. | string (UUID) |
name | Name assigned to the caption file. | string |
extension | File extension of the caption file, typically "vtt". | string |
createdAt | Timestamp when the caption file was created, in ISO 8601 format. | string |
origin | Source of the caption file upload, "TRANSCRIBE" or "UPLOAD". | string |
captioningJobId | Unique identifier for the captioning job. | string (UUID) |
autoGenerated | Indicates whether the caption file was generated automatically. | boolean |
content | VTT file content containing caption text. | string |
statusCode | Status code message, e.g., "NO_SPEECH_DETECTED" if applicable. | string |
errorMessage | Error message if the caption retrieval failed; null if successful. | string or null |
Sample Response
{ "type": "CLOSED_CAPTIONS", "assetId": "123e4567-e89b-12d3-a456-426614174000", "name": "latest_captions", "extension": "vtt", "createdAt": "2025-10-30T10:15:30Z", "origin": "TRANSCRIBE", "captioningJobId": "987e6543-e21b-45d3-a123-456789abcdef", "autoGenerated": true, "content": "WEBVTT\n\n00:00:00.000 --> 00:00:02.000\nWelcome to the latest captions.\n\n00:00:02.500 --> 00:00:04.000\nGenerated automatically.", "statusCode": "NO_SPEECH_DETECTED", "errorMessage": null
}
Updated 2 days ago