Multi Upload Tool Limits API
Per-account daily publishing limits.
Per-account daily publishing limits.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/multi-upload-tool-com:multi-upload-tool-com-limits-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Multi Upload Tool Limits API
version: 1.0.0
summary: Publish and schedule video and photo posts to TikTok, YouTube, Instagram, Facebook, LinkedIn, Pinterest, Bluesky and Threads from one API.
description: 'REST API for the Multi Upload Tool platform.
Upload a video or photo once and publish it to one or many connected social accounts, immediately or on a schedule. The API also covers connected-account management, upload history, per-account daily limits, webhooks, teams, white-label connection links, short links and custom domains.
## Authentication
Every endpoint requires an API token sent in the `x-api-key` header. Tokens are created from the dashboard and look like `kmb_`.
```
x-api-key: kmb_0123456789abcdef...
```
## Permission model
A token carries **scopes**, chosen when it is created in the dashboard. `*` grants everything: it is what every token created before scopes existed holds, and what a token created without a list gets. Otherwise the token holds `resource:action` scopes — `posts:read`, `posts:write`, `posts:publish`, `accounts:read`, `accounts:write`, `analytics:read`, `pools:read`, `pools:write`, `webhooks:read`, `webhooks:write`, `team:read`, `team:write`, `links:read`, `links:write`. `write` includes `read`, and `posts:publish` includes `posts:write`. A token with `posts:write` but not `posts:publish` can create posts, but they are always held for approval. Each operation states what it needs in `x-required-scope`; a call without it returns `403` with `code: INSUFFICIENT_SCOPE` and `requiredScope`.
On top of scopes, **team scoping** applies.
- A token created against a team is permanently pinned to that team. It can only read and write that team''s resources, and it is revoked automatically if the user leaves the team.
- An unscoped token may target a team per-request with the `X-Team-ID` header. Membership is verified on every call.
- Inside a team, the member''s role (`OWNER`, `ADMIN`, `MEMBER`) gates privileged operations. Members cannot create webhooks; only owners and admins can invite or remove members; only an owner can remove an admin.
Treat an API token as a credential and store it accordingly; give each integration only the scopes it needs.
## Large media
A file part sent to `POST /upload` must stay under 100 MB, an edge limit on the request body rather than a platform one. For anything larger, call `POST /upload/presign` to get URLs that put the bytes straight into storage, then publish by passing the returned `bucketUrl` (preferred for large video) or `accessUrl` in the `video`, `photo` or `file` field.
## Rate limits
Limits are applied per IP and per endpoint group; exceeding one returns `429`. The tightest limits are on writes: 50 requests / 15 min for `POST /upload`, 20 requests / 15 min for `POST /upload/bulk` and for destructive operations. Reads are typically 100 requests / 5-15 min. A single IP may also present at most 10 distinct API tokens per hour.
## Errors
Errors return a JSON body of the form `{ "success": false, "error": "..." }`. Validation failures on `POST /upload` additionally return a per-field `errors` array.'
termsOfService: https://multi-upload-tool.com/terms
contact:
name: Multi Upload Tool support
url: https://multi-upload-tool.com/about
email: support@multi-upload-tool.com
servers:
- url: https://api.multi-upload-tool.com/api/v1
description: Production
security:
- apiKey: []
tags:
- name: Limits
description: Per-account daily publishing limits.
paths:
/platforms/capabilities:
get:
tags:
- Limits
summary: Platform capabilities
description: Caption and title limits, daily post cap, accepted media and required settings for each platform, as data. Without `platform`, every platform is returned as an array. A null limit means the platform has no such field.
operationId: getPlatformCapabilities
x-required-scope: posts:read
parameters:
- name: platform
in: query
required: false
description: Return one platform only.
schema:
$ref: '#/components/schemas/Platform'
responses:
'200':
description: One capabilities object, or an array of them when `platform` is omitted.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
oneOf:
- type: object
- type: array
items:
type: object
'401':
$ref: '#/components/responses/Unauthorized'
'422':
description: Unknown platform.
'429':
$ref: '#/components/responses/RateLimited'
/x-credits:
get:
tags:
- Limits
summary: Get credit balance
description: 'One credit balance pays X posts and AI features. X: 1 credit per post, 15 when the text contains a link (detected with X''s own twitter-text rules). AI: 1 per started minute of video, after the plan''s monthly AI minutes (field ai). Returns the X balance (plan allowance left this month + purchased credits, which never expire), the cost per X post, the packs on sale and the AI minutes left.'
operationId: getXCredits
x-required-scope: posts:read
responses:
'200':
description: Balance, prices and packs.
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
properties:
balance:
type: object
properties:
monthlyAllowance:
type: integer
description: Credits included in the plan each UTC month.
includedRemaining:
type: integer
purchased:
type: integer
description: Bought in packs; never expire.
total:
type: integer
description: includedRemaining + purchased.
costs:
type: object
properties:
post:
type: integer
example: 1
linkPost:
type: integer
example: 15
packs:
type: array
items:
type: object
properties:
name:
type: string
credits:
type: integer
price:
type: number
ai:
type: object
description: 'AI minutes: used before purchased credits.'
properties:
monthlyMinutes:
type: integer
includedRemaining:
type: integer
credits:
type: integer
description: Purchased credits (same balance as balance.purchased).
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
/limits/{accountId}:
get:
tags:
- Limits
summary: Get daily publishing limits
description: Returns how many posts the account may still publish today and when the window resets. Limits are imposed by the social platform, not by Multi Upload Tool.
operationId: getAccountLimits
x-required-scope: posts:read
parameters:
- name: accountId
in: path
required: true
schema:
type: string
responses:
'200':
description: The account's current limit state.
content:
application/json:
schema:
$ref: '#/components/schemas/Limits'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
components:
responses:
NotFound:
description: No such resource, or it does not belong to the caller.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: The API key is missing, invalid, revoked or expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
RateLimited:
description: Too many requests for this endpoint group.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
Platform:
type: string
description: A supported social platform.
enum:
- tiktok
- youtube
- instagram
- facebook
- linkedin
- pinterest
- bluesky
- threads
- x
Error:
type: object
required:
- success
- error
properties:
success:
const: false
error:
type: string
description: Human-readable failure reason.
statusCode:
type: integer
Limits:
type: object
properties:
success:
const: true
allowed:
type: boolean
description: Whether another post may be published right now.
used:
type: integer
limit:
type: integer
remaining:
type: integer
resetAt:
type: string
format: date-time
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
description: 'API token created from the dashboard, in the form `kmb_<64 hex characters>`.
A token carries a list of scopes, chosen when it is created: `*` (everything — every token created before scopes existed, and any token created without a list) or `resource:action` scopes such as `posts:read` or `analytics:read`. Each operation states the scope it needs in `x-required-scope`; a token without it gets `403` with `code: INSUFFICIENT_SCOPE`. A token with `posts:write` but not `posts:publish` can create posts, which are always held for approval. On top of scopes, team scoping applies: baked into the token at creation time or requested per-call with `X-Team-ID`. Store it as you would a password.'
externalDocs:
description: Full API documentation
url: https://docs.multi-upload-tool.com/api-reference