Generate platform-optimized social post variants from a topic using the MisarPost AI generation API.

Generate Post Variants

POST/api/generate

Generates up to 5 platform-optimized post variants per platform from a single topic. Uses the Misar AI engine.

Request body

topicstringbodyrequired

Topic or description for the posts. Min 3, max 500 characters.

platformsstring[]bodyrequired

Platforms to generate for. Must include at least one. Allowed values: twitter, linkedin, instagram, threads, tiktok, bluesky, youtube.

tonestringbodydefault: professional

Writing tone. One of: professional, casual, technical, inspirational.

countnumberbodydefault: 3

Number of variants to generate per platform. Min 1, max 5.

Response fields

variantsarray

One entry per requested platform.

variants[].platformstring

Platform identifier.

variants[].variantsarray

Generated variants for this platform. Each has caption (string) and hashtags (string[]).

{
  "topic": "We just open-sourced our TypeScript SDK with 100% test coverage",
  "platforms": ["twitter", "linkedin"],
  "tone": "technical",
  "count": 3
}

{
  "variants": [
    {
      "platform": "twitter",
      "variants": [
        {
          "caption": "Just open-sourced our TypeScript SDK — 100% test coverage, full types, works in Node, Bun, and Deno. Give it a star ⭐",
          "hashtags": ["TypeScript", "OpenSource", "SDK"]
        },
        {
          "caption": "Our TypeScript SDK is now open source. Zero dependencies, strict types, 100% test coverage. Built for production. 🧵",
          "hashtags": ["TypeScript", "DevTools"]
        }
      ]
    },
    {
      "platform": "linkedin",
      "variants": [
        {
          "caption": "Excited to announce that our TypeScript SDK is now fully open source...",
          "hashtags": ["OpenSource", "TypeScript", "DeveloperTools"]
        }
      ]
    }
  ]
}

{
  "error": "Monthly generation limit reached. Upgrade to Pro for unlimited generations.",
  "limitReached": true
}

Rate Limits and Plan Gates

Tier	Monthly AI generations
Free	10
Pro	Unlimited
Growth Suite	Unlimited

When the free tier limit is reached, the response is 429 with limitReached: true.

Enhance Text

POST/api/generate/enhance

Rewrites existing post content to be more engaging while preserving the core message.

Request body

textstringbodyrequired

The text to enhance.

platformstringbodyrequired

Target platform for platform-specific formatting.

tonestringbodydefault: professional

Desired tone after enhancement.

Generate Hashtags

POST/api/generate/hashtags

Generates relevant hashtags for a piece of text.

Request body

textstringbodyrequired

Post content to generate hashtags for.

platformstringbodyrequired

Target platform (affects hashtag count and style).

countnumberbodydefault: 5

Number of hashtags to generate.

Optimization Insights

GET/api/generate/optimize

Returns AI-powered optimization insights derived from the authenticated user's post performance over the last 30 days — best time of day to post, best-performing tone, top hashtags, and platform-specific guidance.

Query parameters

platformstringquery

Restrict the insights to a single platform. Omit to get insights across all platforms.

Response fields

bestTimeOfDaystring

Recommended time of day to publish, based on historical engagement.

bestTonestring

The tone that has performed best for this account.

topHashtagsstring[]

Highest-performing hashtags from recent posts.

promptSuggestionsstring[]

Suggested prompts for the next round of AI generation.

platformInsightsobject

Per-platform optimization notes.

AI Content Generation

Generate Post Variants

Rate Limits and Plan Gates

Enhance Text

Generate Hashtags

Optimization Insights