PowerPost APIv1
PowerPost APIv1
DashboardAPI keysPowerPost API
QuickstartAuthenticationWorkspacesErrors & Rate Limits
Input TypesPost TypesCreditsResearch Modes
Generate CaptionsGenerate ImagesPublish and ScheduleWebhooksMCP Server

Content

Generate ContentGenerations

Media

Upload MediaGenerate ImagesGenerate VideosVideo Captions

Publishing & planning

PostsPublish & SchedulePost ItemsAnalyticsCalendar

Account

Get Credits
Changelog
Concepts

Post Types

Supported platforms, post types, and media/caption/title limits.

Post types tell PowerPost which platform surface you are targeting — for example instagram-reel vs instagram-feed. You pass them when generating captions and when creating posts.

Multiple post types from the same platform (e.g. instagram-reel and instagram-feed) produce one shared caption for that platform. The post type still matters for publishing, because media and field rules differ.

Supported post types

PlatformPost Types
Instagraminstagram-feed, instagram-reel, instagram-story
TikToktiktok-video, tiktok-photos
YouTubeyoutube-video, youtube-short
Xx-post
Facebookfacebook-post, facebook-reel, facebook-story
LinkedInlinkedin-post
Threadsthreads-post

Media, Caption, and Title Limits

Each post_type has its own media, caption, and title rules. Missing required media, fewer than the minimum media count, and a caption or title over its max length (or a missing required title) all return a 400 VALIDATION_ERROR on create, publish, and schedule — except Stories, where content is ignored if present (see footnote). Caption length is measured the same way the target platform does (see footnotes). Stay within these limits so publish doesn't fail on the platform side.

Post TypeMediaCaption MaxTitleHashtags
instagram-feedRequired, 1–10 images/videos (can mix as a carousel)2,200Not supported30
instagram-reelRequired, exactly 1 video2,200Not supported30
instagram-storyRequired, exactly 1 image or videoNot supported****Not supported—
tiktok-videoRequired, exactly 1 video2,200Not supportedNo limit
tiktok-photosRequired, 1–35 images4,000Optional, max 90 charsNo limit
youtube-videoRequired, exactly 1 video5,000 bytes*Required, max 100 chars60**
youtube-shortRequired, exactly 1 video5,000 bytes*Required, max 100 chars60**
x-postOptional, up to 4 images, or 1 video, or 1 GIF (not mixed)280***Not supportedNo limit
facebook-postOptional, up to 10 images, or 1 video (not mixed)63,206Not supportedNo limit
facebook-reelRequired, exactly 1 video63,206Not supportedNo limit
facebook-storyRequired, exactly 1 image or videoNot supported****Not supported—
linkedin-postOptional, up to 1 image or video, or 2–20 images (MultiImage)3,000Not supportedNo limit
threads-postOptional. Text only, 1 image or video, or a 2–20 item carousel (images and videos can mix)500*****Not supportedOne topic tag

* YouTube description limit is 5,000 UTF-8 bytes (not characters). Emoji and non-Latin text use more than one unit each toward the cap.

** YouTube ignores every hashtag in the title and description if their combined count goes over 60.

*** X free/Basic: 280. Premium and Premium+: up to 25,000. Length is weighted the same way X counts posts (emoji and CJK count as 2; every URL counts as 23).

**** Instagram and Facebook Stories are media-only in the platform APIs (no caption field on story publish). content is optional for those post types, and anything you send is ignored rather than rejected.

***** Threads counts 500 characters. Emoji count as UTF-8 bytes (one emoji can use several units). Regular letters, including non-Latin, count as 1. At most 5 unique URLs in the text (https://… or www.…). More than 5 fails on create.


Related

  • Generate content — post_types on caption generation
  • Create post — items use post_type
  • Publish settings — TikTok/YouTube privacy, Threads who-can-reply

Input Types

Generate content from text, images, or video.

Credits

How PowerPost credits work — when they're charged, refunded, and checked.

On this page

Supported post typesMedia, Caption, and Title LimitsRelated