Entwickler
Dokumentation, Header und Erkennung der Entwickler-API
Die externe API, der API-Schlüssel-Workflow, der MCP-Transport und die maschinenlesbaren Erkennungsdateien werden hier mit den vom Produkt verwendeten Live-Pfaden dokumentiert.
API-Schlüssel
Erstellen und widerrufen Sie Schlüssel unter Dashboard > Einstellungen > API-Schlüssel oder verwenden Sie die angemeldeten Verwaltungsrouten.
Nur Professional und Enterprise.
REST-API
Call https://tubeanalytics.net/api/external/v1 with Bearer auth.
JSON-Antworten mit strukturierten Fehlern.
MCP-Transport
Connect agents to https://tubeanalytics.net/api/mcp or use npm run mcp:stdio.
Streambares HTTP und stdio werden unterstützt.
Discovery-Dateien
Use /openapi.json, /mcp.json, /ai-pricing.json, and /ai.txt as the machine-readable source of truth.
Immer aktuell mit den Live-Routen.
Schnellstart
Versuchen Sie es mit einem Live-Endpunkt. Ersetzen Sie „channel_id“ und „ YOUR_API_KEY“ durch echte Werte:
curl -X GET "https://tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Accept: application/json"JavaScript
const res = await fetch("https://tubeanalytics.net/api/external/v1/analytics?channel_id=<id>&range=28d", {
headers: { Authorization: "Bearer <api_key>" }
});
const data = await res.json();Python
import httpx
res = httpx.get(
f"{apiBase}/analytics",
params={"channel_id": "<id>", "range": "28d"},
headers={"Authorization": "Bearer <api_key>"}
)
data = res.json()channel_id accepts either the TubeAnalytics channel ID or the YouTube channel ID. The same Bearer key works for every external endpoint below. API access requires a Professional or Enterprise plan.So verbinden Sie sich
Verknüpfen Sie einen YouTube-Kanal im Dashboard
Externe API-Daten stammen von verbundenen Kanälen. Melden Sie sich an, verbinden Sie einen Kanal und warten Sie, bis die erste Synchronisierung abgeschlossen ist, bevor Sie Server-zu-Server-Aufrufe tätigen.
Erstellen Sie einen API-Schlüssel
Öffnen Sie Dashboard > Einstellungen > API-Schlüssel in einem Professional- oder Enterprise-Konto oder rufen Sie POST /api/v1/keys aus einer authentifizierten Sitzung auf.
Senden Sie über den Inhaber authentifizierte Anfragen
Verwenden Sie Authorization: Bearer <api_key> bei jeder externen Anfrage. Behalten Sie die Schlüssel serverseitig bei und betten Sie sie nicht in den Clientcode ein.
Verwenden Sie Erkennungsdateien für Tools und Agents
Rufen Sie die OpenAPI-Spezifikation, das MCP-Manifest, das AI-Pricing-Manifest und die Datei ai.txt ab, wenn Sie Clients generieren, Agenten verbinden oder Integrationen validieren.
Referenzendpunkte
Abfrageparameter
Die meisten externen API-Endpunkte akzeptieren allgemeine Abfrageparameter zum Filtern, Paginieren und Sortieren. Das vollständige Schema pro Endpunkt ist in der OpenAPI-Spezifikation enthalten.
channel_idrangelimitoffsetsortAuthentifizierung und Header
Externe Anfragen verwenden das Bearer-API-Schlüsselschema im Authorization-Header. Behalten Sie den Schlüssel serverseitig. Erstellen und rotieren Sie Schlüssel über Dashboard > Einstellungen > API-Schlüssel oder die angemeldeten Verwaltungsrouten.
- Authorization
- Bearer <api_key>
- Accept
- application/json
- Content-Type
- application/json
- Rate-limit headers
- X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- Retry header
- Retry-After on 429 responses
Angemeldete Verwaltungsrouten
Diese Routen gelten für authentifizierte Dashboard-Sitzungen, nicht für Server-zu-Server-API-Clients:
GET /api/v1/keysAPI-Schlüssel auflistenPOST /api/v1/keysErstellen Sie einen neuen API-SchlüsselDELETE /api/v1/keys/:keyIdeinen Schlüssel widerrufenGET /api/v1/users/profile and related dashboard session routesbleiben getrennt
Zugang und Grenzen
Die Preisoberfläche kündigt monatliche API-Aufrufkontingente nach Plan an, während die externe Live-API ein Anforderungslimit mit gleitendem Fenster erzwingt und bei jeder Antwort Ratenlimit-Header zurückgibt. Berücksichtigen Sie beides beim Erstellen von Client-Wiederholungsversuchen und Kontingent-Dashboards.
In der aktuellen Implementierung gibt die externe API X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset bei erfolgreichen Antworten zurück, plus Retry-After, wenn eine Anfrage begrenzt ist.
Fehlerformat
Externe API-Routen geben strukturierte JSON-Fehler mit error.code und error.message zurück. Verwenden Sie den Code, um auf die Fehlerbehandlung und die Meldung für menschenlesbare Protokolle zu verzweigen.
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}Gemeinsame Status
- 400 Fehlende oder ungültige Anforderungsparameter
- 401 Fehlender oder ungültiger API-Schlüssel
- 403 API-Schlüssel gültig, aber der Plan ist nicht berechtigt
- 404 Verbundener Kanal oder Ressource nicht gefunden
- 429 Ratenlimit überschritten
- 500 Unerwarteter Serverfehler
Bereit zum Bauen?
Melden Sie sich für einen Professional- oder Enterprise-Plan an, um API-Zugriff zu erhalten. Sie haben bereits ein Konto? Wechseln Sie zum Dashboard, um API-Schlüssel zu erstellen.