Acclaira API Reference

curl -X POST "https://acclaira.com/api/v1/generate/caption" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"headline": "Pakistan IT exports reach record high in 2026", "language": "mixed"}'

{
  "success": true,
  "headline": "Pakistan IT exports reach record high in 2026",
  "caption": "🚀 Big News for Pakistan! 🇵🇰 Humaray IT sector ne 2026 mein history create kardi hai! Pakistan ki IT exports ab tak ke record high par pohanch chuki hain...\n\nFreelancers aur tech startups ki continuous mehnat rang le aayi hai. Kya aapko lagta hai ke Pakistan region ka next biggest tech hub ban sakta hai? Apni raye comments mein zaroor share karein! 👇",
  "hashtags": "#PakistanTech #ITExports #DigitalPakistan #TechNews #FreelancersPakistan",
  "keywords": "Pakistan IT exports, record IT exports 2026, Pakistan tech industry, Digital Pakistan",
  "cost": 1,
  "remaining": 14
}

curl -X POST "https://acclaira.com/api/v1/generate/article" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "State Bank of Pakistan announces new monetary policy"}'

{
  "success": true,
  "topic": "State Bank of Pakistan announces new monetary policy",
  "title": "State Bank of Pakistan Unveils Landmark Monetary Policy Update",
  "article": "In a pivotal economic briefing today, the State Bank of Pakistan announced key updates to its monetary policy framework, aiming to balance inflation targets while fostering sustained industrial growth...\n\nKey takeaways:\n• Strategic policy adjustment to stimulate economic momentum\n• Enhanced credit accessibility for small and medium enterprises\n• Stability measures targeted for foreign exchange markets",
  "full_text": "State Bank of Pakistan Unveils Landmark Monetary Policy Update...",
  "meta": "State Bank of Pakistan announces key updates to its monetary policy framework to foster industrial growth and maintain currency stability.",
  "cost": 2,
  "remaining": 12
}

curl -X POST "https://acclaira.com/api/v1/generate/urdu-script" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "Petrol prices reduced tonight across Pakistan"}'

{
  "success": true,
  "topic": "Petrol prices reduced tonight across Pakistan",
  "script": "ناظرین، اس وقت کی بڑی خبر... حکومت نے پیٹرولیم مصنوعات کی قیمتوں میں بڑی کمی کا اعلان کر دیا ہے۔ عوام کے لیے ریلیف کا یہ فیصلہ آج رات بارہ بجے سے نافذ العمل ہوگا۔ آپ کی اس بارے میں کیا رائے ہے؟ کمنٹس میں بتائیے۔",
  "language": "ur",
  "cost": 3,
  "remaining": 9
}

curl -X POST "https://acclaira.com/api/v1/publish/wordpress" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Economic Growth Accelerates in Q3", "content": "Full story details...", "status": "publish"}'

{
  "success": true,
  "post_id": 1420,
  "link": "https://yoursite.com/economic-growth-accelerates-in-q3/",
  "status": "publish",
  "title": "Economic Growth Accelerates in Q3"
}

curl -X POST "https://acclaira.com/api/v1/publish/meta" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"caption": "Breaking news update 🔥 #Breaking", "imageBase64": "data:image/png;base64,iVBORw..."}'

{
  "success": true,
  "post_id": "104928374928172_93849182739182",
  "url": "https://facebook.com/104928374928172_93849182739182"
}

curl -X GET "https://acclaira.com/api/v1/sources/fetch" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "count": 3,
  "items": [
    {
      "title": "Pakistan tech exports increase by 28% in latest quarterly review",
      "link": "https://example-news.com/tech-exports-surge",
      "pubDate": "Mon, 17 Aug 2026 21:00:00 GMT",
      "description": "The Ministry of IT reports steady acceleration across freelance and corporate sectors.",
      "sourceUrl": "https://example-news.com/feed.xml"
    }
  ]
}

curl -X GET "https://acclaira.com/api/v1/me" \
  -H "Authorization: Bearer acc_live_YOUR_API_KEY" \
  -H "Accept: application/json"

{
  "user": {
    "id": 1,
    "email": "user@domain.com",
    "name": "Alex",
    "role": "user",
    "plan": "pro",
    "credits": 250,
    "status": "active"
  },
  "costs": {
    "caption_post": 1,
    "article": 2,
    "urdu_video": 3
  },
  "integrations": {
    "wordpress": {
      "configured": true,
      "live": true,
      "url": "https://yoursite.com"
    },
    "meta": {
      "configured": true,
      "live": true,
      "page_id": "104928374928172"
    },
    "ai_engine": {
      "configured": true
    }
  },
  "auth": {
    "type": "api_key",
    "key_name": "My Custom Frontend"
  }
}

curl -X GET "https://acclaira.com/api/v1/health"

{
  "status": "healthy",
  "version": "v1",
  "service": "Acclaira REST API",
  "timestamp": "2026-08-18T00:00:00.000Z",
  "endpoints": {
    "auth_check": "GET /api/v1/me",
    "generate_caption": "POST /api/v1/generate/caption",
    "generate_article": "POST /api/v1/generate/article",
    "generate_urdu_script": "POST /api/v1/generate/urdu-script",
    "publish_wordpress": "POST /api/v1/publish/wordpress",
    "publish_meta": "POST /api/v1/publish/meta",
    "sources_fetch": "GET /api/v1/sources/fetch",
    "docs": "GET /api/v1/docs"
  }
}