Docs›API Reference
REST API

API Reference

All server-side endpoints exposed by the APIverse platform. Base URL: https://apiverse.dev

All endpoints are unauthenticated unless noted. Rate limiting applies in production.
Search
POST/api/search

AI-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

FieldTypeRequiredDescription
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
Proxy
POST/api/proxy

Server-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

FieldTypeRequiredDescription
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
Compose
POST/api/compose

AI 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

FieldTypeRequiredDescription
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
Auth
GET / POST/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