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
  • What is the Blotato API?
  • Get Your API Key
  • Authentication
  • Connect Social Accounts
  • Examples
  • Next Steps
  1. API

Quickstart

PreviousSocial Platform RequirementsNextMake.com

Last updated 1 month ago

What is the Blotato API?

The Blotato API is a social media API that allows you to publish and schedule posts directly to platforms. You can post any content, such as text, images, and videos.

It is limited to paying subscribers in order to reduce spam and service abuse, keeping Blotato's integration in good standing with the social platforms.


Get Your API Key

Go to Settings and click "Generate API Key".

IMPORTANT: this will end your free trial immediately and start your paid subscription.


Authentication

To authenticate API requests, include your Blotato API key in the request headers.

Authentication Header

blotato-api-key: YOUR_API_KEY

Requests without a valid API key will be rejected and 401 error will be returned.


Connect Social Accounts

Go to Settings and connect your social accounts.

You will need the Account ID and Page ID of your social accounts in order to post to them via API.

More information here:


Examples

Post to a Platform Immediately

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

{
  "post": {
    "accountId": "acc_12345",
    "content": {
      "text": "Hello, world!",
      "mediaUrls": [],
      "platform": "twitter"
    },
    "target": {
      "targetType": "twitter"
    }
  }
}

Post at a Scheduled Time

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

{
  "post": {
    "accountId": "acc_67890",
    "content": {
      "text": "Scheduled post example",
      "mediaUrls": [],
      "platform": "facebook"
    },
    "target": {
      "targetType": "facebook",
      "pageId": "987654321"
    }
  },
  "scheduledTime": "2025-03-10T15:30:00Z"
}

Post a Twitter Thread with Multiple Posts

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

{
  "post": {
    "accountId": "acc_13579",
    "content": {
      "text": "This is the first tweet in the thread.",
      "mediaUrls": [],
      "platform": "twitter",
      "additionalPosts": [
        {
          "text": "Here's the second tweet, adding more info.",
          "mediaUrls": []
        },
        {
          "text": "And here's the third tweet to conclude!",
          "mediaUrls": []
        }
      ]
    },
    "target": {
      "targetType": "twitter"
    }
  }
}

Attach Media to Post (images and videos)

If your post has images or videos, you need to first upload the media to Blotato's servers. Most social platforms will reject your request to post random image/video URLs.

  1. Upload media:

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

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

{
  "url": "https://database.blotato.com/d1655c49-0bc4-4dd0-88b2-323ce0069fa4.jpg"
}
  1. Grab the URL from the response, then pass it in your Publish request:

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

{
  "post": {
    "accountId": "acc_24680",
    "content": {
      "text": "Check out this image!",
      "mediaUrls": [
        "https://database.blotato.com/d1655c49-0bc4-4dd0-88b2-323ce0069fa4.jpg",
      ],
      "platform": "instagram"
    },
    "target": {
      "targetType": "instagram"
    }
  }
}

Next Steps

Check out these additional guides:

❗

Make.com Example

n8n Example

API Reference

Social accounts | Blotato Help
Logo