Blotato Help
Blotato Help
  • 🍄Welcome to Blotato!
  • Getting Started
    • 🔥Make Your First 5 Posts
    • 📚Understanding Sources
    • 📅Content Calendar Setup
  • Support
    • 🆘Office Hours
    • ⛑️Get Support
    • 🧠FAQs
  • FEATURES
    • 🎥AI Videos
      • Make Your First AI Video
      • Recommended Workflow
      • Multiple Languages
      • AI Video Credits
      • AI Voiceover Captions
      • Custom Assets
      • Viral Format Examples
      • Troubleshooting
      • FAQs
    • 🖼️AI Images
      • AI Image Credits
    • 💠Inspiration
      • Tutorial
      • Search Topics
      • Shuffle
      • Apply Filters
      • Find Influencers
      • Remix Posts
      • Request Topics
    • 📅Content Calendar
      • Tutorial
      • Create Schedule
      • Schedule Posts
      • Timezone
  • PLATFORMS
    • Linkedin
      • Connect Accounts
      • Supported Posts & Media
      • Best Practices Playbook
      • Repurpose Linkedin Posts
      • Suggested Prompts
      • Troubleshooting
    • Tiktok
      • Connect Accounts
      • Supported Posts & Media
      • Brand New Accounts
      • Best Practices Playbook
      • Brainstorm Tiktok Hooks
      • Repurpose Tiktok Posts
      • Suggested Prompts
      • Troubleshooting
    • Youtube
      • Connect Accounts
      • Troubleshooting
      • FAQs
  • Tips and Tricks
    • 🪝Hooks
    • Growth best practices
    • Search viral trending news
    • Use viral post as template
    • Make output sound like you
    • Manage multiple brand voices
    • Make small edits
    • Translate languages
    • Working on multiple drafts
    • Twitter threads
    • Youtube scripts
    • Social Platform Requirements
  • API
    • Quickstart
    • Make.com
      • Make Basics
      • Make AI Clone
      • Make Faceless Videos
      • Make AI Social Media System
      • Make Slideshows & Carousels
      • Troubleshooting
    • n8n
      • n8n Basics
      • n8n AI Clone
      • n8n Faceless Videos
      • n8n Slideshows & Carousels
      • Troubleshooting
  • API Reference
    • Publish Post /v2/posts
    • Upload Media /v2/media
    • Create Video /v2/videos/creations
    • Find Video /v2/videos/creations/:id
    • Voice IDs
  • Troubleshooting API Errors
  • FAQs
  • Settings
    • Social accounts
      • Facebook
      • Instagram
      • Linkedin
    • API keys
    • Billing & Credits
    • Team access
    • Affiliates
    • FAQs
  • Open Blotato
Powered by GitBook
On this page
  • Upload Media
  • Endpoint
  • Description
  • Request
  • Responses
  • Examples
  • Upload Google Drive
  1. API Reference

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

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

PreviousPublish Post /v2/postsNextCreate Video /v2/videos/creations

Last updated 1 month ago

If you have a link in google drive like this: ​ ​ ​ You can use the following link for your Blotato "upload media" API call: ​ ​ ​ Note how the IDs match: 18-UgDEaKG7YR7AewIDd_Qi4QCLCX5Kop

n8n:

make:

https://drive.google.com/file/d/18-UgDEaKG7YR7AewIDd_Qi4QCLCX5Kop/view?usp=drivesdk
https://drive.google.com/uc?export=download&id=18-UgDEaKG7YR7AewIDd_Qi4QCLCX5Kop
https://youtu.be/D9okDd_1tBI
https://youtu.be/f4Stdm4lDNM