Skip to Content
API ReferenceOverview

API Reference & Workflow

This API allows you to programmatically upload content to TikTok, Instagram, YouTube, Facebook, Pinterest, Bluesky and more. The process is asynchronous to handle large files and platform-specific processing times efficiently.

Architecture Overview

Workflow Overview

The general workflow for uploading content involves two main steps:

  1. Initiate Upload: Send your media file(s) and metadata to the upload endpoint. The server queues the job and returns an uploadId.
  2. Check Status: Poll the status endpoint using the uploadId, or receive a webhook when the upload is complete.

Sequence Diagram

Base URL

https://api.multi-upload-tool.com/api/v1

Authentication

All requests require an API key in the header:

x-api-key: YOUR_API_TOKEN

Generate your API key from the Dashboard  under Settings > API Keys.

Rate Limiting

TypeLimitWindow
Standard requests100 requests15 minutes per IP
UploadsPlatform-specificRolling 24-hour window

When rate limited, the API returns 429 Too Many Requests. See Limits & Quotas for platform-specific daily caps.

Response Format

All responses follow a standard JSON structure:

{ "success": true, "message": "Optional message", "data": { ... }, "error": "Error message (if success is false)" }