Misar IO Docs

Introduction

What MisarSocial is, how it works, and what you can build with it.

What is MisarSocial?

MisarSocial is an AI-powered social media scheduling and content platform. It lets you:

  • Connect Twitter/X, LinkedIn, Instagram, Threads, TikTok, and Bluesky accounts via OAuth
  • Generate platform-optimized post variants from a single topic using the AI generation engine
  • Schedule posts into a BullMQ-backed queue with safety gates (duplicate detection, gap enforcement, daily limits)
  • Monitor trends with TrendPulse — real-time hashtag tracking across configurable niches
  • Repurpose content with ContentRipple — parse a URL or raw text and produce platform-ready variants
  • Track performance with per-post engagement metrics (likes, comments, reposts, impressions)

Authentication

MisarSocial uses Misar SSO for user authentication. Your session from id.misar.io is used for all API calls. For programmatic API access (external integrations), generate an API key from Dashboard → Settings → API Keys.

API key scopes

API keys support granular scopes. The available scopes are posts:read, posts:write, schedule:write, drafts:read, drafts:write, generate:write, stats:read, connections:read, and trendpulse:read.

Rate Limits

Endpoint groupLimit
AI generation20 requests/minute per user
Post scheduling30 requests/minute per user
ContentRipple10 requests/minute per user
Draft bulk actions20 requests/minute per user
General read endpoints60 requests/minute per user

Free Tier Limits

FeatureFree tier
Posts scheduled per month10
AI generations per month10
ContentRipple repurposes per month5

Upgrade to Pro or Growth Suite to remove these limits.

Status

All MisarSocial services are tracked at status.misar.io.