API for Developers

Quick start

Get an API key from your dashboard, then make a POST request:

curl -X POST https://vibecodeidea.com/api/v1/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vci_your_api_key" \
  -d '{
    "skill": "Intermediate",
    "interests": ["AI / ML", "Productivity"],
    "format": "Web app",
    "time": "Weekend",
    "goal": "Portfolio project"
  }'

Authentication

All requests require an API key in the Authorization header. Keys start with vci_ and are generated from your dashboard. Each account can have up to 3 active keys.

Authorization: Bearer vci_your_api_key

Rate limits

Requests are limited per key per day (UTC). Usage is returned in every response.

POST /api/v1/generate

Generates 4 personalised project ideas based on the provided preferences. Returns structured JSON with idea details, tech stacks, and build prompts.

Request body

Allowed values

Response

Returns a JSON object with data (the generated ideas) and usage (your current rate limit status).

{
  "data": {
    "builderProfile": "You are a vibe coder who builds AI-powered productivity tools...",
    "ideas": [
      {
        "title": "AI Meeting Summariser",
        "tagline": "Paste meeting transcripts, get structured notes instantly.",
        "description": "An AI-powered tool that transforms raw meeting transcripts into actionable notes with decisions, action items, and follow-ups. Built for teams who want to stop taking notes and start shipping.",
        "techStack": "Next.js, Supabase, Vercel",
        "keyFeatures": ["Transcript parsing", "Action item extraction", "Team sharing"],
        "difficulty": "Medium",
        "tags": ["ai", "productivity", "saas"],
        "buildPrompt": "Build me a meeting summariser web app..."
      }
    ]
  },
  "usage": {
    "requests_today": 3,
    "daily_limit": 10,
    "remaining": 7
  }
}

Errors