API Reference
All server-side endpoints exposed by the APIverse platform. Base URL: https://apiverse.dev
/api/searchAI-powered semantic search over the API catalog
Accepts a natural-language query and returns a ranked list of matching APIs. Internally routes through Gemini → Groq → Ollama → Mock for the best available semantic ranking.
Request body
querystringoptionalNatural-language search query. Omit to return the full catalog.categorystringoptionalOptional category filter (e.g. "Payments", "AI/ML"). Defaults to "All".Response
{
"results": [ { "id": "stripe", "name": "Stripe", "category": "Payments", ... } ],
"provider": "gemini" // AI provider used, or null if no query
}Error codes
- 400 — invalid JSON body
/api/proxyServer-side HTTP proxy for the Playground
Proxies arbitrary HTTP requests server-side to eliminate CORS restrictions. API keys are sent directly to the target and are never logged. Requests to private/internal hosts are blocked. Response body is capped at 512 KB.
Request body
methodstringrequiredHTTP method: GET, POST, PUT, PATCH, DELETE, HEAD.urlstringrequiredTarget URL (must be https:// or http://).headersobjectoptionalKey-value map of request headers.bodystringoptionalRaw request body string (JSON, form data, etc.).authobjectoptional{ type: "bearer"|"apikey"|"basic"|"none", value: string }Response
{
"status": 200,
"statusText": "OK",
"time": 142, // round-trip ms
"size": "2.4 KB",
"body": "{ ... }", // pretty-printed if JSON
"headers": { "Content-Type": "application/json", ... }
}Error codes
- 400 — missing or invalid URL
- 403 — private/internal host blocked
- 408 — request timed out (>15s)
- 502 — target unreachable or returned an error
/api/composeAI workflow pipeline generation
Accepts a plain-English workflow description and returns a structured multi-step API pipeline with icons, colors, and action descriptions. Uses the AI gateway (Gemini → Groq → Ollama → Mock).
Request body
descriptionstringrequiredNatural-language workflow description, e.g. "user signup flow with email and analytics".Response
{
"steps": [
{ "icon": "🔐", "api": "Auth0", "action": "Verify Session", "desc": "...", "color": "#6366f1" },
{ "icon": "💳", "api": "Stripe", "action": "Create Customer", "desc": "...", "color": "#10b981" }
],
"name": "User Signup Pipeline",
"description": "...",
"provider": "gemini"
}Error codes
- 400 — description missing or empty
- 422 — AI returned an unusable pipeline (try a more specific description)
- 500 — all AI providers failed
/api/auth/[...nextauth]NextAuth.js authentication handler
Handles all auth flows — credentials login, GitHub OAuth, and Google OAuth. Managed by NextAuth v5. Configure providers via GITHUB_CLIENT_ID, GOOGLE_CLIENT_ID environment variables.
Response
// Session object (JWT strategy)
{
"user": {
"id": "demo-you@example.com",
"name": "you",
"email": "you@example.com",
"image": null
}
}Error codes
- 401 — invalid credentials
- 302 — OAuth redirect flows