Find Video /v2/videos/creations/:id
Publishing a Post
Endpoint
Base URL: https://backend.blotato.com/v2
URL: /videos/creations/:id
Method: GET
Description
Retrieve the video status. Useful for polling after creating a video programmatically.
Request
Request Params
The request path parameters must contain the following fields:
Field
Type
Required
Description
id
string
✅
Video ID
Responses
Success Response
Status Code: 200 OK
Every post is scheduled on a queue. Failed posts are available at https://my.blotato.com/failed. The most common issue of failed post is incorrect JSON structure. Please make sure that JSON payload conforms to the structure described above. If you are still having trouble with identifying the issue, please contact support via Intercom and provide your postSubmissionId
.
Response Body:
{
"item": {
"id": "VIDEO ID",
"status": "Queued",
"createdAt": "TIME CREATED",
"mediaUrl": "URL OF THE DONE MEDIA OR NULL IF IT IS NOT READY YET",
"imageUrls": "URLS OF THE DONE IMAGES (FOR SLIDESHOW) OR NULL IF IT IS NOT READY YET"
},
}
Error Responses
Too Many Requests
Post creation has a user-level rate limit of 120 requests / minute to prevent spamming / abusing video polling. The best practice is to poll every 20 seconds if you are animating first image, and 10 seconds if you are not using image to video.
Status Code: 429 Too many requests
{
"statusCode": 429,
"message": "Rate limit exceeded, retry in 49 seconds"
}
Last updated