Loading...
Loading...
Stellen Sie eine Verbindung mit der authentifizierten externen API her oder nutzen Sie den MCP-Transport für Agenten und Entwickler, die auf der Grundlage des YouTube-Analysevertrags aufbauen.
Versuchen Sie es mit einem Live-Endpunkt. Ersetzen Sie channel_id und YOUR_API_KEY durch Ihre Werte:
curl -X GET "https://www.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://www.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()Erstellen und widerrufen Sie API-Schlüssel über Dashboard → Einstellungen → API-Schlüssel oder über die authentifizierten Routen GET /api/v1/keys und POST /api/v1/keys.
Professional+ planRufen Sie die externe API unter https://www.tubeanalytics.net/api/external/v1 mit einem Bearer-Token im Authorization-Header auf.
JSON responsesVerbinden Sie Agenten mit https://www.tubeanalytics.net/api/mcp oder führen Sie npm run mcp:stdio lokal für einen stdio-Transport aus.
Agent readyVerwenden Sie /openapi.json, /mcp.json und /ai.txt als maschinenlesbare Quelle der Wahrheit für Integrationen und Agenten.
Machine-readableMelden Sie sich an, schließen Sie den Abonnementablauf ab und verbinden Sie einen Kanal über das Dashboard. Die authentifizierte Verwaltungsroute ist GET /api/v1/channels/connect für das aktuelle Konto und POST /api/v1/channels/connect zum Verbinden oder Aktualisieren eines Kanals.
Gehen Sie zu Dashboard → Einstellungen → API-Schlüssel und erstellen Sie einen Schlüssel oder verwenden Sie die authentifizierte POST-Route /api/v1/keys. API-Schlüssel sind für die Professional- und Enterprise-Pläne verfügbar.
Verwenden Sie den Bearer-Schlüssel für https://www.tubeanalytics.net/api/external/v1. Beispiel: GET /analytics?channel_id=<id>&range=28d oder GET /videos?channel_id=<id>&limit=20.
Zeigen Sie für MCP-Clients über HTTP auf https://www.tubeanalytics.net/api/mcp oder führen Sie npm run mcp:stdio für den lokalen stdio-Transport aus.
/api/external/v1/channels/api/external/v1/channels/:channelId/api/external/v1/analytics?channel_id=.../api/external/v1/videos?channel_id=.../api/external/v1/audience?channel_id=.../api/external/v1/competitors/api/v1/keys/api/mcpExterne API-Anfragen müssen einen gültigen API-Schlüssel im Autorisierungsheader enthalten, der das Bearer-Token-Schema verwendet. Behalten Sie den Schlüssel serverseitig und legen Sie ihn niemals im clientseitigen Code offen oder übergeben Sie ihn der Versionskontrolle.
Um einen API-Schlüssel zu generieren oder zu rotieren, gehen Sie zu Dashboard → Einstellungen → API-Schlüssel. Sie können Schlüssel auch aus einer authentifizierten Sitzung mit GET /api/v1/keys, POST /api/v1/keys und DELETE /api/v1/keys/:keyId verwalten.
Starter
1 channel · Creators validating one channel before spending more.
Professional
3 channels · Creators and small teams growing more than one channel.
Enterprise
5 channels · Agencies and multi-channel teams with reporting overhead.
curl -X GET https://www.tubeanalytics.net/api/external/v1/analytics?channel_id=<channel_id>&range=28d \
-H "Authorization: Bearer YOUR_API_KEY"Beispiel für eine externe API-Anfrage. „channel_id“ kann die interne DB-ID oder die YouTube-Kanal-ID sein.
Der externe API-Zugriff ist in den Professional- und Enterprise-Plänen verfügbar. Anfragen sind je nach Planstufe ratenbegrenzt und geben 429 mit Ratenlimit-Headern zurück, wenn Sie das Limit überschreiten.
Antwortheader mit Ratenbegrenzung
Jede Antwort von der externen API enthält diese Header, damit Kunden Backoffs proaktiv verwalten können:
X-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetRetry-AfterAuthentifizierte externe Anfragen verwenden den Bearer-API-Schlüsselfluss. Nur sitzungsspezifische Verwaltungsrouten wie /api/v1/keys und /api/v1/channels/connect gelten für die angemeldete Dashboard-Sitzung, nicht für Server-zu-Server-API-Schlüsselaufrufe.
Die externe API gibt strukturierte JSON-Fehler mit error.code und error.message zurück. Angemeldete Dashboard-Routen geben möglicherweise immer noch eine einfache Fehlerzeichenfolge zurück. Überprüfen Sie daher die Route oder die OpenAPI-Spezifikation auf die genaue Form.
Beispielhafte Fehlerreaktion
{
"error": {
"code": "BAD_REQUEST",
"message": "channel_id query parameter is required"
}
}400401403404429500Die meisten externen API-Endpunkte akzeptieren allgemeine Abfrageparameter zum Filtern, Paginieren und Sortieren.
channel_idrangelimitoffsetsortÜbertragen Sie Kanalmetriken in Ihre eigenen Tools – betten Sie Diagramme in interne Portale, Kundenberichte oder BI-Plattformen wie Metabase oder Grafana ein.
Planen Sie nächtliche Synchronisierungen in Google Sheets, Notion oder Ihrem Warehouse, indem Sie die externe API von Ihrem Backend oder Automatisierungsmitarbeiter aus aufrufen.
Verwenden Sie den MCP-Transport oder den lokalen stdio-Transport, um Agenten Zugriff auf denselben Produktvertrag, dieselben Analysen und dieselben Kontodaten zu gewähren.
Kombinieren Sie API-Daten mit Anzeigen, CRM oder Finanzsystemen, um die Kanalleistung mit dem Rest Ihres Stacks in Einklang zu bringen.
Verwenden Sie diese Seiten, um von der Endpunkterkennung zur Produktionsintegration und Workflow-Bereitstellung zu gelangen.
Zentrale Entwicklerdokumente: Authentifizierung, Endpunkte, MCP und Erkennungsdateien.
Schnellstart für den ersten API-Aufruf, die Authentifizierungseinrichtung und die Rollout-Checkliste.
Ereignisnutzlasten und Wiederholungsverhalten für Abonnement- und Datenereignisse.
Planbewusste Anforderungslimits und Wiederholungsstrategie für stabile Integrationen.
Integrationsspezifische Implementierungsreferenz und Datensynchronisierungsbereich.
API-Zugriff ist in den Professional- und Enterprise-Plänen verfügbar. Registrieren Sie sich, verbinden Sie einen Kanal, erstellen Sie dann einen API-Schlüssel und beginnen Sie mit dem Aufruf der externen API oder des MCP-Transports.