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

Research Modes

Choose regular or deep research when generating captions.

Caption generation takes a research_mode of regular or deep. It controls how much context PowerPost gathers before writing.

ModeBest forCost
regularFast drafts, simple announcements, high volumeLower
deepHigher engagement, nuanced topics, competitive nichesHigher

How to set it

Pass research_mode on every content generate request:

{
  "prompt": "We just shipped dark mode across all our apps",
  "post_types": ["instagram-reel", "tiktok-video"],
  "research_mode": "regular"
}

Source URLs

Separately, you can pass source_urls (up to 10 public http(s) URLs). PowerPost scrapes those pages and uses them as research context. That works with any input type (text, images, or video) and adds to generation cost.

Non-public or blocked URLs are rejected with 400 and no credits are charged for that request.

Writing styles

Research mode is independent of brand voice. Pass writing_style_id (from Settings → Writing Styles) to keep tone consistent. If you omit it, generation uses your active style if you have one, otherwise no custom style.

Related

  • Generate content — Full request body
  • Credits — How research affects spend
  • Input types — Text, image, and video input

Credits

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

Generate Captions

End-to-end flow for caption generation — start a job, poll or use webhooks, regenerate one platform.

On this page

How to set itSource URLsWriting stylesRelated