Misar Docs
MisarMailMisar.BlogMisarReachMisarPostMisar.DevMisar PlatformMisar IdentityMisar Posts API
Api Reference

AI Content Generation

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

TierMonthly AI generations
Free10
ProUnlimited
Growth SuiteUnlimited

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.

Optimize Post

POST/api/generate/optimize

Optimizes post content for a specific platform's character limits, formatting conventions, and engagement patterns.

Request body

textstringbodyrequired

Post content to optimize.

platformstringbodyrequired

Target platform.