Postmoore — Social Media Assistant#

Autonomously manage social media posting via the Postmoore API.

Setup#

1. Create a Postmoore account at postmoo.re
2. Connect your social accounts (Instagram, TikTok, YouTube Shorts, LinkedIn, Facebook, Threads, Bluesky)
3. Go to Profile → API Keys and generate an API key (Creator or Premium plan required)
4. Store your key in your workspace .env:

text

POSTMOORE_API_KEY=pm_live_xxxxx

Auth#

All requests use a Bearer token:

text

Authorization: Bearer <POSTMOORE_API_KEY>

Base URL: https://postmoo.re/api/v1

Core Workflow#

1. Get Social Accounts#

text

GET /accounts

Optional filter by platform:

text

GET /accounts?platform=tiktok

Supported platform values: instagram · tiktok · ytshorts · linkedin · facebook · threads · bluesky

Returns an array of connected accounts. Each account has:

• id — use this in every post request
• platform — the platform name
• displayName — the account display name
• platformUsername — username on the platform
• status — always active

Always fetch account IDs before posting — never guess them.

2. Upload Media#

text

POST /media
Content-Type: multipart/form-data

file: <binary>

Supported formats: image/jpeg · image/png · image/gif · image/webp · video/mp4 · video/quicktime · video/webm

Max file size: 100 MB. Storage quota: 5 GB (Creator plan) · 20 GB (Premium plan).

Returns:

json

{
  "data": {
    "id": "uploads/user123/filename.mp4",
    "type": "video",
    "url": "https://storage.postmoo.re/...",
    "mimeType": "video/mp4",
    "size": 10485760,
    "filename": "video.mp4"
  }
}

Save both id and url — you need both when creating a media post.

3. Create a Post#

text

POST /posts
Content-Type: application/json

Text post (post now):

json

{
  "contentType": "text",
  "text": "Your caption here #hashtags",
  "accounts": ["<account_id_1>", "<account_id_2>"],
  "schedule": { "type": "now" }
}

Text post (scheduled):

json

{
  "contentType": "text",
  "text": "Scheduled caption #hashtags",
  "accounts": ["<account_id_1>"],
  "schedule": { "type": "scheduled", "at": "2026-06-01T14:00:00Z" }
}

Media post (image or video):

json

{
  "contentType": "media",
  "text": "Caption for the post #hashtags",
  "media": [{ "id": "<id_from_upload>", "url": "<url_from_upload>" }],
  "accounts": ["<account_id_1>", "<account_id_2>"],
  "schedule": { "type": "now" }
}

Draft (save without publishing):

json

{
  "contentType": "text",
  "text": "Draft caption to review",
  "accounts": ["<account_id_1>"],
  "schedule": { "type": "draft" }
}

schedule options:

• { "type": "now" } — publish immediately
• { "type": "scheduled", "at": "<ISO 8601 datetime>" } — schedule for future
• { "type": "draft" } — save as draft, no publishing

Returns post object with:

• id — post ID
• status — pending · scheduled · published · failed · draft
• accounts — array of { id, platform }
• results — per-platform result with success, postId, url, error

4. List Posts#

text

GET /posts
GET /posts?status=scheduled
GET /posts?status=draft&page=1&limit=20

Status filters: pending · scheduled · published · failed · draft

Pagination params: page (default 1) · limit (default 20, max 100)

Returns paginated array with data and pagination object containing page, limit, total, totalPages, hasMore.

5. Get a Single Post#

text

GET /posts/<post_id>

Returns full post object including per-platform results.

6. Delete a Post#

text

DELETE /posts/<post_id>

Only works on posts with status pending or draft. Scheduled and published posts cannot be deleted.

Returns { "data": { "id": "<post_id>", "deleted": true } }.

Recommended Workflow for Video Content#

1. Ask the user for the video file path

2. Extract a frame to understand the content: text

   ffmpeg -i video.mp4 -ss 00:00:03 -frames:v 1 frame.jpg -y
   
   

3. Read the frame and write a caption with 4–5 relevant hashtags

4. Upload the video: POST /media

5. Get account IDs: GET /accounts

6. Create the post with the media id and url from the upload

7. Confirm status: GET /posts/<post_id>

Tips#

• Post to multiple platforms in one request by including multiple account IDs
• Use "type": "draft" when the user wants to review content before it goes live
• Stagger scheduled posts throughout the day for better reach
• Keep hashtags to 4–5 per post
• Always confirm account IDs from GET /accounts before every session
• Check the results array after posting for per-platform success or failure details
• If a post fails on one platform but succeeds on others, the overall status will be failed — check individual results