publishing

Upload media from URL

General

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 1GB file size or smaller.

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

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.

post/v2/media

Request body

urlstring required

The URL of the media to upload.

Example request

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

Response

Default Response

urlstring required

Uploaded and validated blotato media URL.

idstring required

The internal ID of the uploaded media.

Example response

{
  "url": "https://database.blotato.io/media/12345.jpg",
  "id": "media_12345"
}

Changes

Changed in 2 of the 8 revisions of this API.9

    • added the optional property action to the response with the 403 status

      response-optional-property-added

    • added the optional property action to the response with the 422 status

      response-optional-property-added

    • added the optional property action to the response with the 429 status

      response-optional-property-added

    • added the optional property action to the response with the 500 status

      response-optional-property-added

    • added the optional property details to the response with the 403 status

      response-optional-property-added

    • added the optional property details to the response with the 422 status

      response-optional-property-added

    • added the optional property details to the response with the 429 status

      response-optional-property-added

    • added the optional property details to the response with the 500 status

      response-optional-property-added

    • added the non-success response with the status 403

      response-non-success-status-added