API Reference

Generate AI-powered captions optimized for specific social platforms.

{
  "platform": "instagram",
  "prompt": "Launch day for our new product",
  "tone": "exciting",
  "length": "medium",
  "include_hashtags": true,
  "include_emojis": true,
  "target_audience": "millennials"
}

{
  "caption": "🚀 Launch day is finally here! We're thrilled to unveil our latest innovation...",
  "hashtags": ["#LaunchDay", "#Innovation", "#NewProduct"],
  "character_count": 142,
  "platform_optimized": true
}

Create AI-generated images for social media posts.

{
  "prompt": "Minimalist product photo on gradient background",
  "style": "professional",
  "dimensions": {
    "width": 1080,
    "height": 1080
  },
  "format": "png"
}

{
  "image_url": "https://cdn.blackspace.ai/images/abc123.png",
  "width": 1080,
  "height": 1080,
  "format": "png",
  "generation_time": 2.4
}

Get trending and relevant hashtags for your content.

{
  "content": "New sustainable fashion collection launch",
  "platform": "instagram",
  "count": 10,
  "mix": "trending_and_niche"
}

{
  "hashtags": [
    "#SustainableFashion",
    "#EcoFriendly",
    "#SlowFashion",
    "#EthicalStyle"
  ],
  "trending_score": 8.5,
  "estimated_reach": 150000
}

Publish content immediately to one or multiple platforms.

{
  "platforms": ["instagram", "x", "facebook"],
  "content": {
    "text": "Check out our new product! 🚀",
    "media": [
      {
        "type": "image",
        "url": "https://cdn.example.com/image.jpg"
      }
    ],
    "hashtags": ["#launch", "#innovation"]
  },
  "publish_immediately": true
}

{
  "post_id": "post_abc123",
  "status": "published",
  "published_at": "2025-10-05T14:30:00Z",
  "platforms": {
    "instagram": {
      "post_id": "ig_123",
      "url": "https://instagram.com/p/abc123"
    },
    "x": {
      "post_id": "x_456",
      "url": "https://x.com/user/status/456"
    },
    "facebook": {
      "post_id": "fb_789",
      "url": "https://facebook.com/posts/789"
    }
  }
}

Schedule posts for future publishing with optimal timing.

{
  "platforms": ["instagram", "x"],
  "content": {
    "text": "Weekend vibes! 😎",
    "media": [...]
  },
  "schedule_time": "2025-10-06T10:00:00Z",
  "use_optimal_time": false,
  "timezone": "America/New_York"
}

{
  "post_id": "post_def456",
  "status": "scheduled",
  "scheduled_for": "2025-10-06T10:00:00Z",
  "platforms": ["instagram", "x"],
  "can_edit_until": "2025-10-06T09:50:00Z"
}

Retrieve details and status of a specific post.

{
  "post_id": "post_abc123",
  "status": "published",
  "content": {...},
  "platforms": {...},
  "created_at": "2025-10-05T14:20:00Z",
  "published_at": "2025-10-05T14:30:00Z",
  "metrics": {
    "total_views": 5420,
    "total_likes": 312,
    "total_shares": 45
  }
}

Get detailed performance metrics for a specific post.

{
  "post_id": "post_abc123",
  "overall_metrics": {
    "views": 15420,
    "likes": 892,
    "comments": 67,
    "shares": 124,
    "engagement_rate": 6.8
  },
  "platform_breakdown": {
    "instagram": {
      "views": 8500,
      "likes": 612,
      "engagement_rate": 7.2
    },
    "x": {
      "views": 4200,
      "likes": 156,
      "engagement_rate": 3.7
    },
    "facebook": {
      "views": 2720,
      "likes": 124,
      "engagement_rate": 4.5
    }
  },
  "best_performing_platform": "instagram",
  "audience_demographics": {
    "age_groups": {...},
    "locations": {...}
  }
}

Get overall account performance across all platforms.

?start_date=2025-09-01&end_date=2025-10-01&platforms=instagram,x

{
  "date_range": {
    "start": "2025-09-01",
    "end": "2025-10-01"
  },
  "summary": {
    "total_posts": 45,
    "total_views": 125000,
    "total_engagement": 8500,
    "average_engagement_rate": 6.8,
    "follower_growth": 1250
  },
  "best_performing_posts": [...]
  "optimal_posting_times": {
    "instagram": "14:00-16:00 EST",
    "x": "09:00-11:00 EST"
  }
}