UGC VZ für Developer & KI-Agenten

REST-API (OpenAPI 3.1)

Spezifikation: /openapi.json — fünf Operationen: searchCreators, getCreator, requestOutreach, getOutreachStatus, getVocab. Fehler kommen als RFC 7807 (application/problem+json) mit Fehlercode und Lösungshinweis.

curl -X POST https://ugc-vz.de/api/v1/creators/search \
  -H "Content-Type: application/json" \
  -d '{"query":"Beauty-Creatorin in Berlin für TikTok-Produktvideo","max_results":5}'

Wichtig: POST /api/v1/outreach löst eine echte Kontaktanfrage mit E-Mail-Versand aus — kein Test-Endpunkt.

MCP-Server (Claude, ChatGPT & Co.)

Streamable-HTTP-Endpunkt: https://ugc-vz.de/api/mcp — Manifest unter /.well-known/mcp.json, Tool-Schemas unter /api/agent-schemas/<tool>.json.

// Claude Code
claude mcp add --transport http ugc-vz https://ugc-vz.de/api/mcp

// Claude Desktop / andere MCP-Clients (mcp-remote als stdio-Brücke)
{ "mcpServers": { "ugc-vz": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://ugc-vz.de/api/mcp"] } } }

5 Tools: search_creators, get_creator, request_outreach, get_outreach_status, get_vocab. Suchergebnisse enthalten niemals private Kontaktdaten.

A2A & weitere Discovery-Endpunkte

• /.well-known/agent-card.json — A2A v1.0 Agent Card (Endpunkt: /a2a)
• /.well-known/ucp — Universal-Commerce-Protocol-Manifest
• /llms.txt — Inhaltsverzeichnis für Sprachmodelle inkl. „Wann UGC VZ nutzen“
• /sitemap.xml — vollständige Seitenliste

Zentrale Seiten liefern auf Accept: text/markdown eine Markdown-Variante (Content-Negotiation nach acceptmarkdown.com).

Fehler, Limits & Verhalten

• Fehlerformat: RFC 7807 application/problem+json mit code, detail und resolution; unbekannte /api/*-Pfade antworten strukturiert mit 404.
• Rate-Limits: IP-basiert; Suche zählt mehrfach. Bei 429 den Retry-After-Header beachten. Höhere Limits über Web Bot Auth-Signaturen.
• Datenschutz: Öffentliche Endpunkte geben niemals private Kontaktdaten zurück. Kontaktdaten erhält die Brand erst nach bewusster Anfrage per E-Mail.
• Kosten: Suche, Profile und Vermittlung sind kostenlos, keine Provision.
• Versionierung & Deprecation: URL-Versionierung (/api/v1). Abkündigungen kündigen wir mindestens 6 Monate vorher an — per Deprecation- und Sunset-Header auf den betroffenen Endpunkten und hier auf dieser Seite.