API Overview

​

Authentication

Authorization: Bearer <mallary_api_key>

​

Base URL

https://mallary.ai

​

Flow Example: video post to multiple platforms

const uploadMetaRes = await fetch("https://mallary.ai/api/v1/upload", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    filename: file.name, // launch.mp4
  }),
});

const uploadMeta = await uploadMetaRes.json();

// Example output:
// {
//   uploadUrl: "https://...",
//   mediaUrl: "https://files.mallary.ai/uploads/launch.mp4",
//   headers: { "Content-Type": "application/octet-stream" }
// }

await fetch(uploadMeta.uploadUrl, {
  method: "PUT",
  headers: uploadMeta.headers ?? {},
  body: file,
});

// Example output: HTTP 200/204 from uploadMeta.uploadUrl.

const postRes = await fetch("https://mallary.ai/api/v1/post", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    message: "Check out our new product!",
    platforms: ["tiktok", "youtube", "facebook", "instagram"],
    media: [{ url: uploadMeta.mediaUrl }],
    comments_under_post: ["Find out more at https://example.com today"],
    auto_reply_enabled: true,
  }),
});

const post = await postRes.json();
const jobId = post.jobs[0].jobId;

// Example output:
// {
//   status: "queued",
//   batch_id: "a1b2c3d4",
//   jobs: [{ platform: "facebook", jobId: "123", platform_post_id: null, platform_post_url: null }]
// }

const jobRes = await fetch(`https://mallary.ai/api/v1/jobs/${jobId}`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
});

const { data } = await jobRes.json();

console.log(data.job);

// Example output:
// {
//   id: "123",
//   platform: "facebook",
//   status: "completed",
//   platform_post_id: "1234567890",
//   platform_post_url: "https://www.facebook.com/..."
// }

​

Core API Features

• presigned media uploads
• post creation and scheduling
• job status retrieval
• grouped post listing
• comment listing and supplied replies
• deletion of queued or scheduled posts
• analytics snapshots
• follower and subscriber counts for connected accounts
• connected platform listing
• connection profile management
• profile-scoped brand and AI auto-reply settings
• platform disconnects
• webhook listing, creation, and deletion

​

Supported Platforms

• twitter
• x
• facebook
• instagram
• linkedin
• youtube
• tiktok
• pinterest
• reddit
• threads
• bluesky

​

Posting Features

• one or more target platforms
• optional profile_id for non-default connection profiles
• media attachments
• comments_under_post
• optional scheduling with scheduled_at. Send an absolute timestamp such as 2026-04-06T18:30:00Z
• timezone-aware scheduling with scheduled_timezone. A local 2026-04-06T14:30 then resolves in an IANA timezone such as America/New_York
• optional per-post AI auto-reply override
• per-platform platform_options
• optional webhook_url
• optional Idempotency-Key

​

Platform Options

• Facebook
• Instagram
• TikTok
• YouTube
• Pinterest
• Reddit
• Threads
• Bluesky

​

Platform-Specific Media Rules

• Threads supports text, image, video, and carousel post types. Carousel posts support 2 to 20 supported media items.
• YouTube requires exactly one video.
• Instagram supports feed, story, reel, and carousel post types. Stories use one image/video, Reels use one video, and carousels support 2 to 10 mixed media items.
• Pinterest requires exactly one image or GIF, or exactly one video, and also requires boardId.
• Reddit image posts require one image or GIF. The current public API path does not support Reddit video upload.
• TikTok supports one video for video posts, or up to 35 images for photo posts.
• X allows up to 4 images or 1 video or 1 GIF.

​

Connection Profiles

• Free: 1
• Starter: 4
• Pro: 10
• Business: 50

​

Rate Limits

• plan 1: 75 req/min
• plan 2: 150 req/min
• plan 3: 750 req/min
• plan 4: 1500 req/min

​

Plan-Gated Features

• posting limits
• analytics availability
• AI auto-reply availability