agentHub
API

API-Referenz

Vollständige REST-API-Dokumentation.

Basis-URL
Authentifizierung
JSON-Antworten

Authentifizierung

Alle Anfragen erfordern API-Schlüssel im Authorization-Header als Bearer-Token.

// Header
Authorization: Bearer your-api-token

API-Schlüssel geheim halten. Nie im Client-Code.

Endpunkte

GET/api/agentsAlle Agenten mit Metadaten, Bewertungen und Preisen auflisten.

Parameter

categorystringFilter by category (Development, Analytics, Legal, ...)
searchstringSearch in name, description and tags
backendstringFilter by compatible backend (e.g. openai, claude, ollama)
pricingstringFilter: "free" or "paid"
sortstringSort: popular, newest, rating (default: newest)
pagenumberPage number (default: 1)
limitnumberResults per page (1–50, default: 12)
Antwort: { agents: Agent[], total: number, page: number }
GET/api/agents/:slugDetails zu einem Agenten abrufen.

Parameter

slugstringUnique agent slug (URL param)
Antwort: { ...AgentDetail, author: { id, name, username }, reviews: Review[] }
GET/api/agents/:slug/reviewsBewertungen eines Agenten (paginiert).

Parameter

slugstringAgent slug (URL param)
pagenumberPage number (default: 1)
limitnumberResults per page (1–50, default: 10)
Antwort: { reviews: Review[], total: number, page: number }
GET/api/agents/:slug/similarGet similar agents from the same category.

Parameter

slugstringAgent slug (URL param)
Antwort: { agents: Agent[] }
POST/api/agents/:slug/installBezahl-Agent installieren. Vom Guthaben abgezogen.

Parameter

slugstringAgent slug (URL param)
backendstringTarget backend (default: "openai")
Antwort: { success: boolean, message: string, config: InstallConfig }
POST/api/agents/install-freeKostenloser Agent. Auth erforderlich.

Parameter

agentSlugstringAgent slug (body)
emailstringEmail for delivery (body)
Antwort: { ok: boolean }
POST/api/agents/:slug/reviews🔒Bewertung für installierten Agent.

Parameter

ratingnumberRating 1–5 (required)
commentstringReview text (optional)
Antwort: { id, rating, comment, agentId, userId, createdAt }
GET/api/payments/wallet🔒Guthabenstand und Transaktionen.
Antwort: { balance, totalEarned, totalWithdrawn, available, stripeAccountStatus }

Datentypen

Agent

  id: string
  slug: string
  name: string
  description: string
  icon: string | null
  category: string
  agentType: "prompt_based" | "app_ui"
  compatible: string[]
  tags: string[]
  pricing: { type: "one_time", amount?: number }
  rating: number
  installs: number
  isFeatured: boolean
  createdAt: string (ISO 8601)
  author: { id: string, name: string }

Review

  id: string
  rating: number (1–5)
  comment: string | null
  agentId: string
  userId: string
  user: { name, username, avatarUrl }
  createdAt: string (ISO 8601)
Zurück zur DokumentationEntwicklung starten →