API Guide

Authorization: Bearer ak_your_api_key_here

curl -X POST https://appcruiser.com/api/v1/ideas \
  -H "Authorization: Bearer ak_your_key" \
  -H "Content-Type: application/json" \
  -d '{"title":"My Idea","description":"A productivity app","category":"Productivity","tags":["ai"]}'

import { AppCruiserClient } from "@appcruiser/sdk";

const client = new AppCruiserClient({ apiKey: "ak_your_key" });
const idea = await client.createIdea({
  title: "My Idea",
  description: "A productivity app",
  category: "Productivity",
  tags: ["ai"],
});
console.log(idea.id);

import requests

resp = requests.post("https://appcruiser.com/api/v1/ideas",
    headers={"Authorization": "Bearer ak_your_key"},
    json={
        "title": "My Idea",
        "description": "A productivity app",
        "category": "Productivity",
        "tags": ["ai"],
    })
idea = resp.json()
print(idea["id"])

# Step 1: Get a presigned upload URL
curl -X POST https://appcruiser.com/api/v1/mockups/upload-url \
  -H "Authorization: Bearer ak_your_key" \
  -d '{"fileName":"index.html","contentType":"text/html"}'
# Returns: { "uploadUrl": "https://s3...", "s3Key": "mockups/..." }

# Step 2: Upload your file to the presigned URL
curl -X PUT "PRESIGNED_URL" -H "Content-Type: text/html" --data-binary @index.html

# Step 3: Create the mockup record with the s3Key from Step 1
curl -X POST https://appcruiser.com/api/v1/mockups \
  -H "Authorization: Bearer ak_your_key" \
  -d '{"name":"My App","description":"A prototype","category":"Gaming","s3Key":"S3_KEY"}'

# Trigger generation
curl -X POST https://appcruiser.com/api/v1/generations \
  -H "Authorization: Bearer ak_your_key" \
  -d '{"ideaId":"IDEA_ID","model":"claude-sonnet-4-6","maxTokens":16000}'
# Returns: { "jobId": "..." }

# Poll until complete (status: queued → processing → completed/failed)
curl https://appcruiser.com/api/v1/generations/JOB_ID \
  -H "Authorization: Bearer ak_your_key"

const { jobId } = await client.generateMockup({ ideaId: "IDEA_ID" });
// Poll until complete (built-in helper)
const job = await client.waitForGeneration(jobId);
console.log("Mockup ready:", job.mockupId);

import requests, time

resp = requests.post("https://appcruiser.com/api/v1/generations",
    headers={"Authorization": "Bearer ak_your_key"},
    json={"ideaId": "IDEA_ID"})
job_id = resp.json()["jobId"]

# Poll until complete
while True:
    status = requests.get(f"https://appcruiser.com/api/v1/generations/{job_id}",
        headers={"Authorization": "Bearer ak_your_key"}).json()
    if status["status"] in ("completed", "failed"):
        break
    time.sleep(3)
print("Mockup ready:", status.get("mockupId"))

# Kick off a CTA video for an idea (or POST /api/v1/mockups/MOCKUP_ID/generate-video)
curl -X POST https://appcruiser.com/api/v1/ideas/IDEA_ID/generate-video \
  -H "Authorization: Bearer ak_your_key" \
  -d '{"tier":"cta","duration":30,"brief":"Energetic 30s promo","language":"en-US"}'
# Returns: { "jobId": "..." }

# Poll until complete (queued → planning → voicing → compiling → rendering → completed)
curl https://appcruiser.com/api/v1/videos/JOB_ID \
  -H "Authorization: Bearer ak_your_key"

# List the voices available to your plan (optional, before generating)
curl "https://appcruiser.com/api/v1/videos/voices?locale=en-US" \
  -H "Authorization: Bearer ak_your_key"

list_video_voices    { "locale": "en-US" }
generate_video       { "tier": "cta", "duration": 30, "targetType": "idea",
                       "targetId": "IDEA_ID", "brief": "Energetic 30s promo", "voiceName": "Roger" }
get_video_status     { "jobId": "..." }
list_videos          { "targetType": "idea", "targetId": "IDEA_ID" }
manage_video         { "videoId": "...", "action": "feature" }
expand_video         { "videoId": "...", "mode": "translate", "languages": ["es-MX","ja-JP"] }
download_video_source{ "jobId": "..." }   # optional — edit the Remotion project locally

POST https://6n262kz00l.execute-api.us-east-2.amazonaws.com/mcp

claude mcp add --transport http appcruiser \
  https://6n262kz00l.execute-api.us-east-2.amazonaws.com/mcp \
  --header "Authorization: Bearer ak_your_api_key"

{
  "mcpServers": {
    "appcruiser": {
      "url": "https://6n262kz00l.execute-api.us-east-2.amazonaws.com/mcp",
      "transport": { "type": "streamableHttp" },
      "headers": { "Authorization": "Bearer ak_your_api_key" }
    }
  }
}

Productivity, Creative, Social, Gaming, Developer Tools,
Finance, Education, Other

{
  "error": "Human-readable message",
  "code": "MACHINE_READABLE_CODE",
  "requestId": "uuid-for-debugging"
}