AI Content Generation

Generate platform-optimized social post variants from a topic using the MisarSocial 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 via assisters.dev.

Body

topicstringrequired

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

platformsstring[]required

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

tonestringdefault: professional

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

countnumberdefault: 3

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

Example Request

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

Response

{
  "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"]
        }
      ]
    }
  ]
}

variantsarray

One entry per requested platform.

variants[].platformstring

Platform identifier.

variants[].variantsarray

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

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:

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

Enhance Text

POST /api/generate/enhance

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

Body

textstringrequired

The text to enhance.

platformstringrequired

Target platform for platform-specific formatting.

tonestringdefault: professional

Desired tone after enhancement.

Generate Hashtags

POST /api/generate/hashtags

Generates relevant hashtags for a piece of text.

Body

textstringrequired

Post content to generate hashtags for.

platformstringrequired

Target platform (affects hashtag count and style).

countnumberdefault: 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.

Body

textstringrequired

Post content to optimize.

platformstringrequired

Target platform.

AI Content Generation

On this page