API Reference

curl https://www.postquick.ai/api/v1/content-groups \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "post": {
      "id": "abc123",
      "content": "Just shipped a new feature...",
      "status": "pending",
      "post_type": "text"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "details": { "retryAfter": 45 }
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_KEY",
    "message": "Invalid or revoked API key."
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "details": { "retryAfter": 45 }
  }
}

curl https://www.postquick.ai/api/v1/content-groups \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "contentGroups": [
      {
        "id": "uuid-abc-123",
        "name": "My Brand",
        "description": "Tech startup social media",
        "created_at": "2026-03-01T10:00:00Z",
        "app_platforms": [
          { "platform": "instagram" },
          { "platform": "twitter" }
        ],
        "social_accounts": [
          {
            "id": "sa-1",
            "platform": "instagram",
            "account_name": "@mybrand"
          }
        ],
        "content_instructions": {
          "brand_name": "My Brand",
          "tone": "professional",
          "target_audience": "Tech founders",
          "unique_angle": "Developer tools"
        }
      }
    ]
  }
}

curl -X POST https://www.postquick.ai/api/v1/content-groups \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Brand",
    "description": "Tech startup social media",
    "platforms": ["instagram", "twitter", "linkedin"]
  }'

{
  "success": true,
  "data": {
    "contentGroup": {
      "id": "uuid-new-456",
      "name": "My Brand",
      "description": "Tech startup social media",
      "created_at": "2026-03-25T14:30:00Z"
    }
  }
}

curl https://www.postquick.ai/api/v1/content-groups/uuid-abc-123 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "contentGroup": {
      "id": "uuid-abc-123",
      "name": "My Brand",
      "description": "Tech startup social media",
      "created_at": "2026-03-01T10:00:00Z",
      "app_platforms": [
        { "platform": "instagram" },
        { "platform": "twitter" }
      ],
      "social_accounts": [
        { "id": "sa-1", "platform": "instagram", "account_name": "@mybrand" }
      ],
      "content_instructions": {
        "brand_name": "My Brand",
        "tone": "professional",
        "target_audience": "Tech founders",
        "unique_angle": "Developer tools",
        "instructions": "Focus on product updates and thought leadership",
        "image_model": "gemini-flash",
        "video_model": "veo-3.1-fast-generate-preview"
      }
    }
  }
}

curl -X DELETE https://www.postquick.ai/api/v1/content-groups/uuid-abc-123 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "message": "Content group deleted successfully"
  }
}

curl https://www.postquick.ai/api/v1/content-groups/uuid-abc-123/instructions \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "instructions": {
      "app_id": "uuid-abc-123",
      "brand_name": "Acme Fitness",
      "target_audience": "Busy professionals aged 25-40",
      "tone": "Motivating, direct, no-nonsense",
      "topics": "Home workouts, nutrition tips, mindset",
      "instructions": "Always include a clear CTA...",
      "include_image": true,
      "image_model": "nano-banana-pro",
      "auto_generate": false,
      "yolo_mode": false,
      "yolo_platforms": [],
      "frequency": "daily",
      ...
    }
  }
}

curl -X PUT https://www.postquick.ai/api/v1/content-groups/uuid-abc-123/instructions \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_name": "Acme Fitness",
    "target_audience": "Busy professionals, 25-40",
    "tone": "Motivating, direct, no-nonsense",
    "topics": "Home workouts, nutrition, mindset",
    "instructions": "Always end with a clear CTA. Avoid fitness jargon.",
    "include_image": true,
    "image_model": "nano-banana-pro"
  }'

{
  "success": true,
  "data": {
    "instructions": {
      "app_id": "uuid-abc-123",
      "brand_name": "Acme Fitness",
      "tone": "Motivating, direct, no-nonsense",
      ...
      "updated_at": "2026-04-17T09:31:02Z"
    }
  }
}

curl "https://www.postquick.ai/api/v1/content-groups/uuid-abc-123/analytics?period=30d&limit=50" \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "groupId": "uuid-abc-123",
    "groupName": "Acme Fitness",
    "period": "30d",
    "totals": {
      "views": 145230,
      "likes": 8912,
      "comments": 423,
      "shares": 1104,
      "saves": 678,
      "engagementRate": 0.0720
    },
    "platformBreakdown": [
      { "platform": "instagram", "totalViews": 89210, "totalLikes": 5612, "postCount": 18, "avgEngagementRate": 0.083 },
      { "platform": "twitter_x", "totalViews": 56020, "totalLikes": 3300, "postCount": 22, "avgEngagementRate": 0.061 }
    ],
    "contentTypeBreakdown": [
      { "postType": "carousel", "postCount": 12, "totalViews": 72100, "avgEngagementRate": 0.092 },
      { "postType": "video", "postCount": 5, "totalViews": 41230, "avgEngagementRate": 0.071 }
    ],
    "topPosts": [
      { "postId": "post-1", "postType": "carousel", "totalViews": 15420, "engagementRate": 0.11, "platforms": ["instagram"] }
    ],
    "dailyTrend": [
      { "date": "2026-03-20", "views": 4821, "likes": 312, "comments": 14, "shares": 42,
        "viewsGained": 318, "likesGained": 21, "commentsGained": 2, "sharesGained": 4 }
    ],
    "totalPostsWithAnalytics": 40
  }
}

curl -X POST https://www.postquick.ai/api/v1/posts/generate \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "generateImage": true
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "app_id": "uuid-abc-123",
      "content": "Just shipped our new AI dashboard ✨\n\nThree months of late nights, 47 cups of coffee, and one very patient designer later — it's live.\n\nThe best tools don't just work. They disappear.\n\n#buildinpublic #saas #ai",
      "status": "pending",
      "post_type": "image",
      "image_url": "https://storage.postquick.ai/post-images/user-123/gemini-flash-abc.png",
      "image_urls": null,
      "video_url": null,
      "platforms": ["instagram", "twitter"],
      "posted_platforms": [],
      "is_manual": false,
      "scheduled_for": null,
      "error_message": null,
      "created_at": "2026-03-25T14:30:00Z",
      "updated_at": null,
      "posted_at": null
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/posts/create \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "content": "Excited to announce our Series A! 🚀\n\n$10M led by @ventureCapital to scale our platform.\n\nThank you to everyone who believed in us.\n\n#startup #funding",
    "postType": "image",
    "platforms": ["instagram", "twitter", "linkedin"],
    "imageUrl": "https://example.com/announcement.jpg"
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-manual-456",
      "app_id": "uuid-abc-123",
      "content": "Excited to announce our Series A! 🚀...",
      "status": "pending",
      "post_type": "image",
      "image_url": "https://example.com/announcement.jpg",
      "platforms": ["instagram", "twitter", "linkedin"],
      "posted_platforms": [],
      "is_manual": true,
      "created_at": "2026-03-25T14:45:00Z"
    }
  }
}

curl "https://www.postquick.ai/api/v1/posts?contentGroupId=uuid-abc-123&status=pending" \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "posts": [
      {
        "id": "post-1",
        "content": "Post content here...",
        "status": "pending",
        "post_type": "image",
        "image_url": "https://...",
        "platforms": ["instagram"],
        "created_at": "2026-03-25T14:30:00Z"
      },
      {
        "id": "post-2",
        "content": "Another post...",
        "status": "pending",
        "post_type": "text",
        "platforms": ["twitter"],
        "created_at": "2026-03-25T12:00:00Z"
      }
    ],
    "pagination": { "limit": 50, "hasMore": false, "nextCursor": null }
  }
}

curl https://www.postquick.ai/api/v1/posts/post-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "app_id": "uuid-abc-123",
      "content": "Just shipped our new AI dashboard ✨...",
      "status": "posted",
      "post_type": "image",
      "image_url": "https://storage.postquick.ai/...",
      "platforms": ["instagram", "twitter"],
      "posted_platforms": ["instagram", "twitter"],
      "created_at": "2026-03-25T14:30:00Z",
      "posted_at": "2026-03-25T15:00:00Z"
    }
  }
}

curl -X PUT https://www.postquick.ai/api/v1/posts/post-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Updated caption with new CTA ✨\n\nClick link in bio!",
    "platforms": ["instagram", "twitter", "threads"]
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "content": "Updated caption with new CTA ✨\n\nClick link in bio!",
      "platforms": ["instagram", "twitter", "threads"],
      "updated_at": "2026-03-25T15:30:00Z",
      ...
    }
  }
}

curl -X PATCH https://www.postquick.ai/api/v1/posts/post-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Fixed typo in caption" }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "content": "Fixed typo in caption",
      "status": "pending",
      "updated_at": "2026-05-14T16:42:00Z",
      ...
    }
  }
}

curl -X DELETE https://www.postquick.ai/api/v1/posts/post-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "deleted": true,
    "mediaRetained": true,
    "platformPostsDeleted": false
  }
}

curl -X POST https://www.postquick.ai/api/v1/posts/post-xyz-789/publish \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "twitter"]
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "status": "posted",
      "posted_platforms": ["instagram", "twitter"],
      "posted_at": "2026-03-25T15:00:00Z",
      ...
    },
    "publishedTo": ["instagram", "twitter"],
    "errors": []
  }
}

curl -X POST https://www.postquick.ai/api/v1/posts/post-xyz-789/schedule \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "scheduledFor": "2026-04-01T10:00:00Z",
    "platforms": ["instagram", "twitter"]
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "status": "scheduled",
      "scheduled_for": "2026-04-01T10:00:00Z",
      "platforms": ["instagram", "twitter"],
      ...
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/posts/post-xyz-789/regenerate \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "instructions": "Make it shorter, more punchy, and add a clear CTA.",
    "generateImage": false
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "content": "(rewritten text)",
      "image_url": "...",
      "updated_at": "2026-04-17T09:42:00Z",
      ...
    }
  }
}

curl -X PUT https://www.postquick.ai/api/v1/posts/post-xyz-789/images \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "set_multiple_images",
    "imageUrls": [
      "https://cdn.example.com/slide1.jpg",
      "https://cdn.example.com/slide2.jpg"
    ]
  }'

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "image_url": null,
      "image_urls": ["https://cdn.example.com/slide1.jpg", "https://cdn.example.com/slide2.jpg"],
      ...
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/posts/post-xyz-789/reset-platforms \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "post": {
      "id": "post-xyz-789",
      "posted_platforms": [],
      "error_message": null,
      ...
    }
  }
}

curl https://www.postquick.ai/api/v1/posts/post-xyz-789/analytics \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "postId": "post-xyz-789",
    "postType": "post",
    "totals": {
      "views": 15420,
      "likes": 892,
      "comments": 41,
      "shares": 104,
      "saves": 23,
      "engagementRate": 0.067
    },
    "platforms": [
      { "platform": "instagram", "views": 12100, "likes": 780, "comments": 35, "shares": 82, "fetched_at": "2026-04-17T08:00:00Z" },
      { "platform": "twitter_x", "views": 3320, "likes": 112, "comments": 6, "shares": 22, "fetched_at": "2026-04-17T08:00:00Z" }
    ],
    "history": [
      { "snapshot_date": "2026-04-15", "views": 8210, "likes": 512, "comments": 22 }
    ],
    "lastFetched": "2026-04-17T08:00:00Z"
  }
}

curl -X POST https://www.postquick.ai/api/v1/stories \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "storyType": "video",
    "mediaUrl": "https://cdn.example.com/story.mp4",
    "duration": 15,
    "platforms": ["instagram", "facebook"]
  }'

{
  "success": true,
  "data": {
    "story": {
      "id": "story-abc-789",
      "app_id": "uuid-abc-123",
      "story_type": "video",
      "video_url": "https://cdn.example.com/story.mp4",
      "duration": 15,
      "aspect_ratio": "9:16",
      "status": "draft",
      "platforms": ["instagram", "facebook"],
      "posted_platforms": [],
      "created_at": "2026-05-13T15:00:00Z"
    }
  }
}

curl "https://www.postquick.ai/api/v1/stories?contentGroupId=uuid-abc-123&status=scheduled" \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "stories": [
      {
        "id": "story-1",
        "story_type": "video",
        "status": "scheduled",
        "scheduled_for": "2026-05-22T15:00:00Z",
        "platforms": ["instagram"],
        ...
      }
    ],
    "pagination": { "limit": 50, "hasMore": false, "nextCursor": null }
  }
}

curl https://www.postquick.ai/api/v1/stories/story-abc-789 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "story": {
      "id": "story-abc-789",
      "status": "posted",
      "story_type": "video",
      "platforms": ["instagram", "facebook"],
      "posted_platforms": ["instagram", "facebook"],
      "posted_at": "2026-05-13T15:01:42Z",
      "expires_at": "2026-05-14T15:01:42Z",
      "platform_post_ids": {
        "instagram": "17891234567890",
        "facebook": "1234567890_9876543210"
      }
    }
  }
}

curl -X DELETE https://www.postquick.ai/api/v1/stories/story-abc-789 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": { "deleted": true, "mediaRetained": true, "platformPostsDeleted": false }
}

curl -X POST https://www.postquick.ai/api/v1/stories/story-abc-789/publish \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram"]
  }'

{
  "success": true,
  "data": {
    "storyId": "story-abc-789",
    "status": "processing",
    "message": "Story publishing initiated. Poll GET /v1/stories/{storyId} for status.",
    "platforms": ["instagram"]
  }
}

curl -X POST https://www.postquick.ai/api/v1/stories/story-abc-789/schedule \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledFor": "2026-05-22T15:00:00Z",
    "platforms": ["instagram", "facebook"],
    "facebookTarget": { "pageId": "123456789" }
  }'

{
  "success": true,
  "data": {
    "story": {
      "id": "story-abc-789",
      "status": "scheduled",
      "scheduled_for": "2026-05-22T15:00:00Z",
      "platforms": ["instagram", "facebook"],
      ...
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/stories/from-post/post-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram"]
  }'

{
  "success": true,
  "data": {
    "story": {
      "id": "story-derived-456",
      "story_type": "image",
      "image_url": "https://cdn.example.com/source-image.jpg",
      "caption": "Inherited from source post",
      "source_post_id": "post-xyz-789",
      "status": "draft",
      "platforms": ["instagram"]
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/captions/generate \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "context": "New AI feature launch"
  }'

{
  "success": true,
  "data": {
    "caption": "🚀 We just launched our most powerful AI feature yet — automated content scheduling that learns YOUR brand voice.\n\nNo more generic posts. No more copy-paste templates. Just authentic content that sounds like you.\n\nTry it free for 14 days. Link in bio. 👆\n\n#AIMarketing #ContentCreation #SocialMediaAutomation"
  }
}

curl -X POST https://www.postquick.ai/api/v1/captions/carousel \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123"
  }'

{
  "success": true,
  "data": {
    "caption": "5 productivity hacks every founder needs 👇\n\nSwipe through to see the exact systems we use to ship faster without burning out.\n\n(Slide 3 is the game-changer 🔥)\n\nSave this for later → you'll need it.\n\n#FounderLife #ProductivityHacks #StartupTips"
  }
}

curl -X POST https://www.postquick.ai/api/v1/captions/video \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "videoTitle": "Behind the scenes of our product design process"
  }'

{
  "success": true,
  "data": {
    "caption": "POV: You're watching our actual design process 🎨\n\n30 seconds from idea → prototype → final product.\n\nThis is how we ship fast without sacrificing quality.\n\nDrop a 🔥 if you want the full breakdown.\n\n#ProductDesign #BehindTheScenes #StartupLife"
  }
}

curl -X POST https://www.postquick.ai/api/v1/content/adjust-tone \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We launched a new feature. Check it out.",
    "targetTone": "enthusiastic",
    "contentGroupId": "uuid-abc-123"
  }'

{
  "success": true,
  "data": {
    "content": "🎉 We just dropped our most exciting feature yet! This is HUGE — you're gonna love it. Go check it out right now! 🚀",
    "targetTone": "enthusiastic"
  }
}

curl -X POST https://www.postquick.ai/api/v1/content/proofread \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Were launching are new feature tommorow. Its going to be amazing, you should definitly check it out!"
  }'

{
  "success": true,
  "data": {
    "corrected": "We're launching our new feature tomorrow. It's going to be amazing, you should definitely check it out!",
    "changes": [
      "Changed 'Were' to 'We're' (missing apostrophe in contraction)",
      "Changed 'are' to 'our' (possessive, not verb)",
      "Changed 'tommorow' to 'tomorrow' (spelling)",
      "Changed 'definitly' to 'definitely' (spelling)"
    ]
  }
}

curl -X POST https://www.postquick.ai/api/v1/content/make-concise \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "I wanted to take a moment to share with you all that we have just launched our brand new feature that we have been working on for several months now. It is something that I think you are all really going to love and appreciate, and I would highly encourage everyone to go ahead and check it out when you get a chance."
  }'

{
  "success": true,
  "data": {
    "content": "Just launched our new feature after months of work. We think you'll love it — check it out!"
  }
}

curl -X POST https://www.postquick.ai/api/v1/content/custom-edit \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We launched a new feature. It helps you schedule posts.",
    "instruction": "Add emojis and a strong call-to-action at the end",
    "contentGroupId": "uuid-abc-123"
  }'

{
  "success": true,
  "data": {
    "content": "🚀 We just launched a game-changing new feature! It helps you schedule posts effortlessly.\n\nTry it now and never miss a posting window again! 👉",
    "instruction": "Add emojis and a strong call-to-action at the end"
  }
}

curl -X POST https://www.postquick.ai/api/v1/hashtags/generate \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Just finished an amazing workout session. Feeling energized and ready to take on the day!",
    "platform": "instagram",
    "count": 10
  }'

{
  "success": true,
  "data": {
    "hashtags": [
      "#Fitness",
      "#WorkoutMotivation",
      "#MorningWorkout",
      "#FitnessJourney",
      "#HealthyLifestyle",
      "#FitFam",
      "#GymLife",
      "#WorkoutComplete",
      "#FitnessGoals",
      "#ActiveLifestyle"
    ]
  }
}

curl -X POST https://www.postquick.ai/api/v1/images/upload \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -F "file=@./slide-1.jpg"

curl -X POST https://www.postquick.ai/api/v1/images/upload \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://res.cloudinary.com/your-cloud/image/upload/v1/slide-1.jpg"
  }'

{
  "success": true,
  "data": {
    "imageUrl": "https://your-project.supabase.co/storage/v1/object/public/post-images/user-uuid/uploads/1711234567890-3f6c....jpg",
    "contentType": "image/jpeg",
    "size": 482103
  }
}

curl -X POST https://www.postquick.ai/api/v1/uploads \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"mediaKind": "image"}'

curl https://www.postquick.ai/api/v1/uploads/upload-uuid-123 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "upload": {
      "id": "upload-uuid-123",
      "mediaKind": "image",
      "status": "uploaded",
      "uploadPageUrl": "https://www.postquick.ai/dashboard/uploads/upload-uuid-123",
      "mediaUrl": "https://your-project.supabase.co/storage/v1/object/public/post-images/user-uuid/uploads/1711234567890-3f6c....jpg",
      "expiresAt": "2026-03-25T17:00:00Z"
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/images/generate \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A modern minimalist office workspace with a laptop, coffee cup, and plants. Natural lighting, warm tones, clean aesthetic. Professional but cozy.",
    "model": "gemini-flash"
  }'

{
  "success": true,
  "data": {
    "imageUrl": "https://your-project.supabase.co/storage/v1/object/public/post-images/user-uuid/1711234567890-image.png",
    "model": "gemini-flash",
    "prompt": "A modern minimalist office workspace with a laptop, coffee cup, and plants. Natural lighting, warm tones, clean aesthetic. Professional but cozy."
  }
}

curl -X POST https://www.postquick.ai/api/v1/videos/upload \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "video/mp4",
    "size": 52428800
  }'

{
  "success": true,
  "data": {
    "uploadUrl": "https://your-project.supabase.co/storage/v1/object/upload/sign/post-videos/user-uuid/uploads/...?token=...",
    "videoUrl": "https://your-project.supabase.co/storage/v1/object/public/post-videos/user-uuid/uploads/1711234567890-3f6c....mp4",
    "method": "PUT",
    "headers": {
      "Content-Type": "video/mp4",
      "x-upsert": "false"
    },
    "expiresIn": 7200,
    "contentType": "video/mp4",
    "size": 52428800
  }
}

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "x-upsert: false" \
  --data-binary @./reel.mp4

# No upload step: reference your existing public video directly.
curl -X POST https://www.postquick.ai/api/v1/videos \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "videoUrl": "https://media.example.com/reels/my-reel.mp4",
    "title": "My Reel",
    "platforms": ["facebook", "tiktok", "youtube", "instagram"],
    "facebookTarget": { "pageId": "123456789" }
  }'

{
  "success": true,
  "data": {
    "video": {
      "id": "video-uuid-xyz-789",
      "status": "draft",
      "video_url": "https://media.example.com/reels/my-reel.mp4",
      "platforms": ["facebook", "tiktok", "youtube", "instagram"],
      "facebook_target": { "pageId": "123456789" }
    }
  }
}

curl "https://www.postquick.ai/api/v1/videos?contentGroupId=uuid-abc-123&status=scheduled" \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "videos": [
      { "id": "video-uuid-xyz-789", "status": "scheduled", "platforms": ["tiktok"] }
    ],
    "pagination": { "limit": 50, "hasMore": false, "nextCursor": null }
  }
}

curl -X POST https://www.postquick.ai/api/v1/videos/generate \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contentGroupId": "uuid-abc-123",
    "prompt": "A close-up of coffee being poured into a white ceramic mug on a wooden table. Morning sunlight streaming through a window. Slow motion, cinematic, warm tones.",
    "model": "veo-3.1-fast-generate-preview",
    "aspectRatio": "9:16",
    "duration": 8
  }'

{
  "success": true,
  "data": {
    "videoPost": {
      "id": "video-uuid-xyz-789",
      "app_id": "uuid-abc-123",
      "title": "",
      "description": "A close-up of coffee being poured into a white ceramic mug on a wooden table. Morning sunlight streaming through a window. Slow motion, cinematic, warm tones.",
      "status": "pending",
      "duration": 8,
      "video_url": null,
      "created_at": "2026-03-25T16:00:00Z"
    },
    "jobId": "job-abc-456",
    "status": "processing",
    "creditsUsed": 1
  }
}

curl https://www.postquick.ai/api/v1/videos/video-uuid-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "video": {
      "id": "video-uuid-xyz-789",
      "app_id": "uuid-abc-123",
      "user_id": "user-uuid-123",
      "title": "Coffee pouring cinematic",
      "description": "A close-up of coffee being poured into a white ceramic mug...",
      "status": "completed",
      "video_url": "https://your-project.supabase.co/storage/v1/object/public/videos/user-uuid/video-xyz.mp4",
      "optimized_video_url": "https://your-project.supabase.co/storage/v1/object/public/videos/user-uuid/video-xyz-optimized.mp4",
      "duration": 6,
      "platforms": ["instagram", "tiktok"],
      "posted_platforms": [],
      "scheduled_for": null,
      "error_message": null,
      "created_at": "2026-03-25T16:00:00Z",
      "updated_at": "2026-03-25T16:04:32Z"
    }
  }
}

curl -X DELETE https://www.postquick.ai/api/v1/videos/video-uuid-xyz-789 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "deleted": true,
    "mediaRetained": true,
    "platformPostsDeleted": false
  }
}

curl -X POST https://www.postquick.ai/api/v1/videos/video-uuid-xyz-789/schedule \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledFor": "2026-04-01T14:00:00Z",
    "platforms": ["instagram", "tiktok"]
  }'

{
  "success": true,
  "data": {
    "video": {
      "id": "video-uuid-xyz-789",
      "status": "scheduled",
      "scheduled_for": "2026-04-01T14:00:00Z",
      "platforms": ["instagram", "tiktok"],
      ...
    }
  }
}

curl -X POST https://www.postquick.ai/api/v1/videos/video-abc-456/reset-platforms \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "video": {
      "id": "video-abc-456",
      "posted_platforms": [],
      "error_message": null,
      ...
    }
  }
}

curl -G https://www.postquick.ai/api/v1/research/search \
  -H "Authorization: Bearer pq_live_your_key_here" \
  --data-urlencode "query=muse wonder api pricing" \
  --data-urlencode "recency=week"

{
  "success": true,
  "data": {
    "results": [
      {
        "title": "Muse Wonder - API Pricing & Providers",
        "url": "https://openrouter.ai/meta/muse-wonder",
        "site": "openrouter.ai",
        "publishedAt": "2026-10-12T00:00:00.000Z",
        "text": "Muse Wonder is priced at $4 per million input tokens...",
        "images": ["https://openrouter.ai/og/muse-wonder.png"],
        "favicon": "https://openrouter.ai/favicon.ico"
      }
    ],
    "searchesUsed": 13,
    "searchesLimit": 500
  }
}

curl -G https://www.postquick.ai/api/v1/research/page \
  -H "Authorization: Bearer pq_live_your_key_here" \
  --data-urlencode "url=https://openrouter.ai/meta/muse-wonder"

{
  "success": true,
  "data": {
    "url": "https://openrouter.ai/meta/muse-wonder",
    "title": "Muse Wonder - API Pricing & Providers",
    "text": "Muse Wonder is priced at $4 per million input tokens...",
    "truncated": false,
    "images": [
      { "url": "https://openrouter.ai/og/muse-wonder.png", "alt": "Muse Wonder pricing" }
    ]
  }
}

# 1. Start the import
curl -X POST https://www.postquick.ai/api/v1/media/imports \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.tiktok.com/@user/video/123"}'

# 2. Check it until status is "ready"
curl https://www.postquick.ai/api/v1/media/jobs/JOB_ID \
  -H "Authorization: Bearer pq_live_your_key_here"

# 3. Cut a vertical clip from seconds 5 to 20
curl -X POST https://www.postquick.ai/api/v1/media/clips \
  -H "Authorization: Bearer pq_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"importId": "JOB_ID", "clips": [{"start": 5, "end": 20, "shape": "9:16"}]}'

{
  "success": true,
  "data": {
    "job": {
      "id": "0f8b6c1e-2c0a-4a0e-9d1f-3b7f7c6a2e11",
      "type": "import",
      "status": "ready",
      "sourceUrl": "https://www.tiktok.com/@user/video/123",
      "resultUrl": "https://…/post-videos/…/import.mp4",
      "durationSeconds": 8.06,
      "width": 576,
      "height": 1024,
      "error": null
    }
  }
}

curl https://www.postquick.ai/api/v1/models/assistant \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "models": [
      {
        "id": "~openai/gpt-luna-latest",
        "label": "Fast",
        "proOnly": false,
        "live": {
          "id": "openai/gpt-6-luna",
          "name": "GPT-6 Luna",
          "maker": "OpenAI",
          "description": "GPT-6 Luna is the fast, cost-efficient model in OpenAI's GPT-6 series, positioned below GPT-6 Sol.",
          "releasedAt": "2026-09-22T00:00:00.000Z",
          "inputPrice": 0.1,
          "outputPrice": 0.5,
          "usable": true
        }
      }
    ]
  }
}

curl https://www.postquick.ai/api/v1/accounts \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "accounts": [
      {
        "id": "acc-uuid-123",
        "app_id": "app-uuid-abc",
        "platform": "instagram",
        "account_name": "@mybrand",
        "token_status": "valid",
        "last_validated_at": "2026-05-14T16:00:00Z",
        "last_validation_error": null,
        "follower_count": 12480,
        "following_count": 312,
        "followers_fetched_at": "2026-05-14T06:00:00Z",
        "created_at": "2026-01-15T10:30:00Z"
      },
      {
        "id": "acc-uuid-456",
        "app_id": "app-uuid-abc",
        "platform": "tiktok",
        "account_name": "mybrand",
        "token_status": "reconnect_required",
        "last_validated_at": "2026-05-13T08:00:00Z",
        "last_validation_error": "TikTok token expired or missing scope",
        "follower_count": 8920,
        "following_count": 105,
        "followers_fetched_at": "2026-05-13T06:00:00Z",
        "created_at": "2026-01-20T14:00:00Z"
      },
      {
        "id": "acc-uuid-789",
        "app_id": "app-uuid-abc",
        "platform": "twitter_x",
        "account_name": "@mybrand",
        "token_status": "valid",
        "last_validated_at": "2026-05-14T12:00:00Z",
        "last_validation_error": "X v2 /users/me requires a paid API tier — follower count not available.",
        "follower_count": null,
        "following_count": null,
        "followers_fetched_at": "2026-05-14T06:00:00Z",
        "created_at": "2026-02-01T09:00:00Z"
      }
    ]
  }
}

curl -X DELETE https://www.postquick.ai/api/v1/accounts/account-uuid-456 \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "deleted": true
  }
}

curl "https://www.postquick.ai/api/v1/accounts/acc-uuid-123/followers?days=90" \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "accountId": "acc-uuid-123",
    "platform": "instagram",
    "followerCount": 12480,
    "followingCount": 312,
    "followersFetchedAt": "2026-05-14T06:00:00Z",
    "history": [
      { "captured_date": "2026-04-15", "follower_count": 11820, "following_count": 305 },
      { "captured_date": "2026-04-16", "follower_count": 11845, "following_count": 305 },
      { "captured_date": "2026-04-17", "follower_count": 11910, "following_count": 308 },
      { "captured_date": "2026-05-14", "follower_count": 12480, "following_count": 312 }
    ]
  }
}

curl https://www.postquick.ai/api/v1/usage \
  -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "plan": "Pro",
    "videoCredits": {
      "used": 12,
      "limit": 30,
      "remaining": 18,
      "resetsAt": "2026-04-01T00:00:00Z"
    },
    "imageGeneration": {
      "used": 87,
      "limit": 300,
      "remaining": 213,
      "resetsAt": "2026-04-01T00:00:00Z"
    },
    "aiTextGeneration": {
      "used": 234,
      "limit": "unlimited"
    },
    "contentGroups": {
      "used": 3,
      "limit": 25
    },
    "rateLimits": {
      "perMinute": {
        "used": 12,
        "limit": 120,
        "remaining": 108,
        "resetsAt": "2026-03-25T17:01:00Z"
      },
      "perDay": {
        "used": 450,
        "limit": 50000,
        "remaining": 49550,
        "resetsAt": "2026-03-26T00:00:00Z"
      }
    }
  }
}

curl https://www.postquick.ai/api/v1/me   -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "user": {
      "id": "user-uuid-123",
      "email": "founder@mybrand.com",
      "plan": "pro",
      "isSubscribed": true,
      "apiEnabled": true
    }
  }
}

// Runs in the dashboard, authenticated by the session cookie.
// An Authorization: Bearer pq_live_ header does NOT work here.
const res = await fetch('/api/v1/keys', {
  credentials: 'include',
});
const { data } = await res.json();
console.log('Active keys:', data.keys.filter(k => !k.revoked_at).length);

{
  "success": true,
  "data": {
    "keys": [
      {
        "id": "key-uuid-123",
        "key_prefix": "pq_live_abc",
        "name": "Production API",
        "last_used_at": "2026-03-25T16:45:00Z",
        "created_at": "2026-01-15T10:00:00Z",
        "revoked_at": null,
        "isActive": true
      },
      {
        "id": "key-uuid-456",
        "key_prefix": "pq_live_xyz",
        "name": "Development",
        "last_used_at": null,
        "created_at": "2026-03-20T14:00:00Z",
        "revoked_at": null,
        "isActive": true
      }
    ],
    "apiEnabled": true,
    "isSubscribed": true,
    "plan": "pro"
  }
}

curl "https://www.postquick.ai/api/v1/analytics?period=30d"   -H "Authorization: Bearer pq_live_your_key_here"

{
  "success": true,
  "data": {
    "summary": {
      "totalRequests": 1247,
      "successRate": 96.1,
      "avgResponseTime": 342,
      "uniqueEndpoints": 12,
      "periodStart": "2026-02-24T00:00:00Z",
      "periodEnd": "2026-03-25T23:59:59Z"
    },
    "requestsOverTime": [
      { "date": "2026-03-24", "total": 67, "success": 64, "errors": 3 },
      { "date": "2026-03-25", "total": 89, "success": 86, "errors": 3 }
    ],
    "byEndpoint": [
      { "endpoint": "/v1/posts/generate", "count": 345, "avgMs": 380, "errorRate": 3.5 },
      { "endpoint": "/v1/images/generate", "count": 287, "avgMs": 290, "errorRate": 2.8 }
    ],
    "byStatusCode": [
      { "code": 200, "count": 1198 },
      { "code": 403, "count": 31 },
      { "code": 500, "count": 18 }
    ],
    "byApiKey": [
      { "keyId": "key-uuid-123", "name": "Production API", "count": 892, "lastUsed": "2026-03-25T16:45:00Z" }
    ],
    "recentErrors": [
      { "endpoint": "/v1/videos/generate", "status": 500, "message": "Video generation service failed", "at": "2026-03-25T16:22:00Z" }
    ],
    "rateLimitStatus": {
      "plan": "pro",
      "minuteLimit": 120,
      "minuteUsed": 9,
      "dailyLimit": 50000,
      "dailyUsed": 1247
    }
  }
}

{
  "id": "9f3a9e6c-2f3b-4d4c-8b8c-1f3f5e7c2a01",
  "event": "post.partial",
  "delivered_at": "2026-05-24T14:00:00.123Z",
  "data": {
    "id": "post-uuid",
    "type": "post",
    "app_id": "app-uuid",
    "status": "partial",
    "posted_platforms": ["instagram", "facebook"],
    "platform_post_ids": {
      "instagram": "18020000000000",
      "facebook": "1234567890_98765"
    },
    "platform_errors": {
      "tiktok": "TikTok requires a video or carousel of 2+ images..."
    },
    "error_message": "Partial failure - tiktok: ...",
    "posted_at": "2026-05-24T13:59:58.987Z",
    "scheduled_at": "2026-05-24T14:00:00.000Z"
  }
}