API Reference

StackPilot analysis API

Send a project description and get a ranked technology stack back. This is the same endpoint that powers the search experience.

Endpoint

bash
POST /api/analyze
Content-Type: application/json

Example request

bash
curl -X POST https://get-stack.vercel.app/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"description": "I want to build a YouTube clone"}';

Response schema

json
{
  "query": "I want to build a YouTube clone",
  "categories": [
    {
      "id": "authentication",
      "name": "Authentication",
      "providers": [
        {
          "name": "Clerk",
          "rank": 1,
          "description": "Drop-in auth with OAuth and session management.",
          "bestUseCases": ["User login", "Multi-tenant SaaS"],
          "website": "https://clerk.com"
        }
      ]
    }
  ]
}

Errors

  • 400The description is empty or too short.
  • 502The AI provider could not be reached. Try again shortly.
  • 500An unexpected server error occurred.

Read the full guide in the API documentation.