Upload Media /v2/media

Upload Media

Endpoint

Base URL: https://backend.blotato.com/v2

URL: /media

Method: POST

Description

This endpoint allows users to upload media by providing a URL. The uploaded media will be processed and stored, returning a new media URL that is used to publish a new post. Most of the platforms require validated URLs for posting images

Request

Request Body

Field	Type	Required	Description
url	string	✅	The URL of the media to upload.

Responses

Success Response

Status Code: 201 Created

Response Body:

{
  "url": "https://database.blotato.com/path-to-uploaded-media.jpg"
}

Error Responses

Internal Server Error

Status Code: 500 Internal Server Error

{
  "code": 9999,
  "message": "An unknown error occurred."
}

Too Many Requests

Media upload has a user-level rate limit of 10 requests / minute.

Status Code: 429 Too many requests

{
  "statusCode": 429,
  "message": "Rate limit exceeded, retry in 49 seconds"
}

Error Codes

The following client error codes may be returned:

Code	Description
9999	Unknown error.

Examples

1. Upload Media

POST https://backend.blotato.com/v2/media HTTP/1.1
Content-Type: application/json

{
  "url": "https://example.com/image.jpg"
}

Response:

{
  "url": "https://database.blotato.com/d1655c49-0bc4-4dd0-88b2-323ce0069fa4.jpg"
}

Upload Google Drive

If you have a link in google drive like this: ​ ​https://drive.google.com/file/d/18-UgDEaKG7YR7AewIDd_Qi4QCLCX5Kop/view?usp=drivesdk ​ You can use the following link for your Blotato "upload media" API call: ​ ​https://drive.google.com/uc?export=download&id=18-UgDEaKG7YR7AewIDd_Qi4QCLCX5Kop ​ Note how the IDs match: 18-UgDEaKG7YR7AewIDd_Qi4QCLCX5Kop

To see examples of how to upload to Blotato from a Google Drive, you can also check out these tutorials and templates:

• n8n: https://youtu.be/D9okDd_1tBI

• make: https://youtu.be/f4Stdm4lDNM

Seeing error "Google Drive can't scan this file for viruses"?

This is the most common issue when using Google Drive. When you try to access your file, you see this popup "Google Drive can't scan this file for viruses":

The issue is when you host a large video on google drive, it will show this popup, which prevents Blotato from accessing the video.

Recommended workaround: if you're regularly posting large videos (100MB+), I recommend using frame.io, an AWS S3 bucket, or similar tool where there is no issue passing around large video files.