# PostMagiq

> Content creation platform that turns raw ideas into publish-ready social media
> posts using AI writing pipelines with human voice matching.

## Quick Start
1. Human signs up at https://postmagiq.com and subscribes (Pro $30/mo)
2. Human creates API key in workspace settings → API Keys
3. Agent uses API key: `X-API-Key: qx_...` header on all requests
4. Base URL: https://postmagiq.com/api/v1/w/{workspace_id}

## Capabilities
- Voice profiles: learn a human's writing voice from samples, or use 6 presets
- Quick posts: create posts with voice, platform, and content style in one call
- Workflow: run multi-stage AI writing pipeline with quality gates (story processor → writer → auditor → synthesizer → AI detection)
- Finished posts: view and edit pipeline output
- Publishing: publish to LinkedIn, X, Threads, Instagram, Facebook, Pinterest, Reddit, Bluesky, Mastodon, Discord, Slack
- Webhooks: subscribe to events (post.published, workflow.completed, etc.)
- Credit management: check balance, purchase credit packs

## Free Tools (no account or API key needed)
Tool index: https://postmagiq.com/tools
Note: free-tool submissions (input + result) are stored for 12 months to improve the
tools, with IP kept only as a salted hash — never sold or shared. Details:
https://postmagiq.com/legal/privacy
- AI-tell checker: check whether text reads as AI-written before posting.
  - Page: https://postmagiq.com/tools/ai-tell-checker
  - API: `POST https://postmagiq.com/api/v1/tools/ai-tell-check` with JSON body `{"content": "<text, 80-3000 chars>"}`
  - Response: `{"band": "pass|borderline|fail", "categories": [<AI-tell patterns found>], "checks_remaining": <int>}`
  - Anonymous limit: 3 checks/day per IP; authenticated users (Bearer token) unlimited
  - Agents are welcome to call this endpoint directly on a human's behalf
- LinkedIn text formatter: bold/italic/underline/strikethrough for LinkedIn posts via Unicode
  Mathematical Alphanumeric Symbols (LinkedIn has no rich text). Runs entirely in the browser.
  - Page: https://postmagiq.com/tools/linkedin-text-formatter
  - Method (for agents formatting text directly): map A-Z/a-z/0-9 to the styled Unicode block,
    e.g. sans-serif bold A = U+1D5D4, a = U+1D5EE, 0 = U+1D7EC. Use sparingly — screen readers
    announce styled characters poorly.
- LinkedIn post preview: renders a post with the feed's "...more" fold (~210 chars / 3 lines on
  desktop, ~140 chars on mobile; line breaks count). Client-side only.
  - Page: https://postmagiq.com/tools/linkedin-post-preview
- LinkedIn character counter: live counts against LinkedIn limits — post 3,000, headline 220,
  About 2,600, connection message 300. Client-side only.
  - Page: https://postmagiq.com/tools/linkedin-character-counter
- LinkedIn hook generator: 10 opening lines for a topic across five styles (question,
  contrarian, stat, story, direct), instructed to avoid AI-detector patterns and never
  invent statistics.
  - Page: https://postmagiq.com/tools/linkedin-hook-generator
  - API: `POST https://postmagiq.com/api/v1/tools/generate-hooks` with JSON body
    `{"topic": "<10-500 chars>", "audience": "<optional>", "tone": "<optional>"}`
  - Response: `{"hooks": [{"text": "...", "style": "question|contrarian|stat|story|direct"}],
    "checks_remaining": <int>}`
  - Anonymous limit: 3 generations/day per IP; authenticated users (Bearer token) unlimited
  - Agents are welcome to call this endpoint directly on a human's behalf
- LinkedIn headline generator: 10 headline options (max 220 chars) across value-prop,
  keyword-rich, structured, and conversational formats; uses only provided facts.
  - Page: https://postmagiq.com/tools/linkedin-headline-generator
  - API: `POST https://postmagiq.com/api/v1/tools/generate-headlines` with JSON body
    `{"role": "<3-100 chars>", "expertise": "<optional>", "audience": "<optional>"}`
  - Response: `{"headlines": ["...", ...], "checks_remaining": <int>}`
  - Anonymous limit: 3 generations/day per IP; authenticated users unlimited
- LinkedIn hashtag generator: 8-12 CamelCase hashtags grounded in the post's content,
  labeled broad (reach) or niche (community). Never claims follower counts.
  - Page: https://postmagiq.com/tools/linkedin-hashtag-generator
  - API: `POST https://postmagiq.com/api/v1/tools/generate-hashtags` with JSON body
    `{"content": "<post text, 20-3000 chars>"}`
  - Response: `{"hashtags": [{"tag": "#CamelCase", "bucket": "broad|niche"}], "checks_remaining": <int>}`
  - Anonymous limit: 3 generations/day per IP; authenticated users unlimited
- LinkedIn post generator: single-pass post draft that is automatically scored against the
  AI-tell checker — the response includes the band so callers see whether the draft reads
  as AI. Never invents statistics (no numbers in topic = no numbers in draft).
  - Page: https://postmagiq.com/tools/linkedin-post-generator
  - API: `POST https://postmagiq.com/api/v1/tools/generate-post` with JSON body
    `{"topic": "<10-500 chars>", "goal": "<optional>", "audience": "<optional>"}`
  - Response: `{"post": "<draft>", "band": "pass|borderline|fail|unchecked",
    "categories": [<AI tells found>], "checks_remaining": <int>}`
  - Anonymous limit: 2 generations/day per IP; authenticated users unlimited

## Authentication
- Header: `X-API-Key: qx_...`
- API keys require Pro tier ($30/month)
- Rate limits: 60 requests/minute, 10,000/day per key
- Keys are workspace-scoped with configurable permission scopes

## Full API Reference
See https://postmagiq.com/llms-full.txt