Upload Media

Upload is Now Optional

You no longer need to upload media to Blotato before publishing. You can pass any publicly accessible image/video URL directly into the mediaUrls parameter in the Publish node. Blotato handles the media transfer automatically.

The Upload Media endpoint is still available if you prefer to use it, or if you need to host media on Blotato's servers.

---

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.

You can upload:

• publicly accessible URLs

• base64 encoded image data

Media uploads are limited to 200MB file size or smaller.

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 30 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
blotato-api-key: YOUR_API_KEY

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

Response:

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

Using Google Drive as a Media Source

Google Drive share links open a viewer page, not a direct file. Blotato needs a direct file URL to fetch and read media.

Set sharing permissions

For automation workflows (n8n, Make.com), set the entire Google Drive folder to "Anyone with the link" as Viewer. All files inside that folder inherit the same permission, so you do not need to set permissions on each file individually.

For one-off uploads, set the individual file to "Anyone with the link" as Viewer.

Common Google Drive URL Errors

Folder URLs don't work: If your link looks like /drive/folders/..., it's a folder link. Blotato needs a direct link to a specific file, not a folder.

Preview URLs don't work reliably: If your link ends with /view?..., it points to Google Drive's preview page, not the raw file.

Use the direct download URL format

For files under 100MB, replace the standard share link with this format:

https://drive.usercontent.google.com/download?id={FILE_ID}&export=download&confirm=t

Replace {FILE_ID} with the ID from your share link. For example, if your share link is:

https://drive.google.com/file/d/1aBcDeFgHiJkLmNoPqRsTuVwXyZ/view

The file ID is 1aBcDeFgHiJkLmNoPqRsTuVwXyZ, so the direct URL is:

https://drive.usercontent.google.com/download?id=1aBcDeFgHiJkLmNoPqRsTuVwXyZ&export=download&confirm=t

Make sure the file is shared with "Anyone with the link" as Viewer.

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

This is the most common issue when using Google Drive. For large videos (100MB+), Google Drive shows a virus-scan popup that blocks Blotato from accessing the file.

For large files, use Dropbox, AWS S3, or Google Cloud Storage instead. These services provide direct download URLs without the virus-scan popup.