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:
- Initiate Upload: Send your media file(s) and metadata to the upload endpoint. The server queues the job and returns an
uploadId. - 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/v1Authentication
All requests require an API key in the header:
x-api-key: YOUR_API_TOKENGenerate your API key from the Dashboard under Settings > API Keys.
Rate Limiting
| Type | Limit | Window |
|---|---|---|
| Standard requests | 100 requests | 15 minutes per IP |
| Uploads | Platform-specific | Rolling 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)"
}