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"
}