{"openapi":"3.0.0","info":{"title":"Acclaira External Developer API","version":"1.0.0","description":"REST API for AI news generation, social media post creation, WordPress publishing, Urdu video scripting, and RSS feeds."},"servers":[{"url":"https://acclaira.com/api/v1","description":"Production Server"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key (e.g. acc_live_...)","description":"Pass your API Key in the Authorization header: `Bearer acc_live_...`"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Alternatively, pass your API key in `x-api-key` header."}}},"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"paths":{"/health":{"get":{"summary":"API Health Check","description":"Check API availability and system timestamp.","responses":{"200":{"description":"API is online and operational"}}}},"/me":{"get":{"summary":"Account Profile & Quota","description":"Retrieve authenticated account details, remaining credit balance, and integration statuses.","responses":{"200":{"description":"User profile and credit balance"},"401":{"description":"Unauthorized"}}}},"/generate/caption":{"post":{"summary":"Generate Social Post (Module 1)","description":"Generate viral social media caption, trending hashtags, and SEO keywords for a headline.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["headline"],"properties":{"headline":{"type":"string","example":"Pakistan signs landmark tech agreement in IT summit"},"language":{"type":"string","enum":["mixed","urdu","english"],"default":"mixed"}}}}}},"responses":{"200":{"description":"Generated caption, hashtags, and keywords"},"401":{"description":"Invalid API Key"},"402":{"description":"Insufficient Credits"}}}},"/generate/image":{"post":{"summary":"Generate Photorealistic AI News Photo","description":"Generate high-definition photorealistic editorial news photography from a headline or visual prompt.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"headline":{"type":"string","example":"Pakistan announces historic solar energy initiative"},"prompt":{"type":"string","example":"Editorial photo of a solar farm with Pakistani flags under clear blue sky"},"width":{"type":"integer","example":1080},"height":{"type":"integer","example":1080}}}}}},"responses":{"200":{"description":"Generated image base64 and direct URL"},"401":{"description":"Invalid API Key"}}}},"/generate/article":{"post":{"summary":"Generate SEO News Article (Module 2)","description":"Generate a complete 350-word SEO news article with headline and 150-char meta description.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["topic"],"properties":{"topic":{"type":"string","example":"State Bank announces new interest rate policy update"}}}}}},"responses":{"200":{"description":"Generated article with meta description"},"401":{"description":"Invalid API Key"},"402":{"description":"Insufficient Credits"}}}},"/generate/urdu-script":{"post":{"summary":"Generate Urdu Video Script (Module 3)","description":"Generate a viral 60-second video script in Urdu Nastaliq for short-form video (Reels, TikTok, Shorts).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["topic"],"properties":{"topic":{"type":"string","example":"Petrol price reduction announced today"}}}}}},"responses":{"200":{"description":"Urdu video script"},"401":{"description":"Invalid API Key"},"402":{"description":"Insufficient Credits"}}}},"/publish/wordpress":{"post":{"summary":"Publish Article to WordPress","description":"Publishes article directly to configured WordPress site via Application Passwords with optional featured image.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","content"],"properties":{"title":{"type":"string"},"content":{"type":"string"},"imageBase64":{"type":"string","description":"Base64 encoded PNG/JPEG for featured image"}}}}}},"responses":{"200":{"description":"Published post URL"}}}},"/publish/meta":{"post":{"summary":"Publish Post to Meta (Facebook/Instagram)","description":"Publishes photo and caption directly to Facebook page and creates an optional first comment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"caption":{"type":"string"},"imageBase64":{"type":"string"},"firstComment":{"type":"string"}}}}}},"responses":{"200":{"description":"Meta post ID and live URL"}}}},"/sources":{"get":{"summary":"List RSS News Sources"},"post":{"summary":"Add RSS Source","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string"},"type":{"type":"string","default":"RSS"},"auto":{"type":"boolean","default":false}}}}}}}},"/sources/fetch":{"get":{"summary":"Fetch Live News Headlines","description":"Parses RSS feeds and returns real-time news headlines.","parameters":[{"name":"url","in":"query","schema":{"type":"string"},"description":"Optional specific RSS feed URL"}]}},"/drafts":{"get":{"summary":"List News Drafts"},"post":{"summary":"Create or Update Draft"}},"/brands":{"get":{"summary":"List Branding Profiles"},"post":{"summary":"Create Branding Profile"}},"/history":{"get":{"summary":"Get Generation & Publishing History"}}}}