Frequently Asked Questions

An API that generates platform-native social posts, threads, short-form clips, and paid-ad creative. One API call connects your site. First thread ships in about 2 minutes. Daily cadence runs automatically after that. The same install also arms networkr.dev (SEO) and outboxr.dev (email) on the same backend.

Organic: X, LinkedIn, Threads, Bluesky, Mastodon, TikTok, YouTube Shorts. Paid ads: Meta Ads, X Ads, LinkedIn Ads, TikTok Ads, Reddit Ads, Google Ads. Add or remove any platform at runtime.

Buffer, Hootsuite, Later, Typefully, SocialBee, Sprout Social schedule posts. They do not write them. They do not shape them per platform. They do not generate short-form clips. They do not run paid ad creative. Viralr does all of it, from your terminal, and does it on the same engine that runs your SEO and email.

Each post goes through a 10-stage pipeline: platform trend research, topic selection with deduplication across the whole suite, competitive shaping, cross-platform reshape, LLM generation with voice constraints, hook/body/CTA shaping, media and clip generation, and publish.

The voice system enforces persona, tone, and banned words. The slop-phrase filter blocks "leverage", "unlock", "game-changing", "truly". Exposure-manifest compliance blocks any post that references product features not already public on your own site.

All three products (viralr, networkr, outboxr) run on one backend. When you run npx viralr init, a single /connect arms organic socials, paid ads, SEO articles, and email outreach under the same API key. Billing runs through networkr.dev. You do not install three products. You install one. See the suite.

Default is a fast, high-quality model via OpenRouter. You can switch any voice to Claude Opus, Claude Sonnet, Claude Haiku, Qwen, DeepSeek, Mistral, Llama, or any of 200+ models on OpenRouter. We use paid, zero-retention API tiers so your prompts never train a public model.

No. The product is 100% API. You get a weekly email digest every Monday with posts shipped, engagement movements, ad-creative performance, topic queue status, and recommendations. If you want a dashboard later, the full REST API is available to build one in your own app.

Yes. POST /api/sites/:id/posts/generate or await vr.generate(siteId) via the SDK. You can pass a specific topic, angle, or restrict to certain platforms.

An optional mode for products being actively built. Connect your GitHub repo, and Viralr turns a week of real commits into a weekly thread-paper: tension framed, what you tried, what broke, one experiment someone else could run. Commit SHAs are checked against the real repo, so the content is unclonable E-E-A-T. Fake build logs cannot pass the gate.

With viralr-ads opted in, the pipeline generates ad creative variants of winning organic threads and rotates them across Meta, X, LinkedIn, TikTok, Reddit, or Google Ads. The Viralr subscription covers the engine; the actual ad spend is charged by the ad platform to the billing instrument you registered there. Viralr never takes custody of your ad budget.

Every Monday morning, each account receives an email with posts shipped per platform, engagement arrow movements, ad-creative performance, topic queue progress bars, pipeline success/failure counts, and orchestrator recommendations. Sent via Mailjet.

Yes. The entire suite engine is a single Docker container. Bring your own API keys (Anthropic or OpenRouter for LLM, OAuth apps for each platform you use). See the API docs for setup instructions.

No. OAuth scopes are limited to post and schedule. No DM automation, no follow-scraping, no synthetic engagement. Cadence is gated per platform per account. Posts are checked against the target platform's content rules before the outbound call. Safety Monitor pauses a surface automatically if warning thresholds approach. We do not do coordinated inauthentic behaviour.

The site stops generating. Platform tokens are revoked on our side and at the platform. Already-published posts stay live on each platform. They are yours.