Developer
API Reference
Authenticate with an API key and use the external REST endpoints.
The public REST API covers connected channels, analytics, videos, audience data, and tracked competitors. Use the OpenAPI specification for request and response details.
Send requests to https://www.tubeanalytics.net/api/external/v1 with Authorization: Bearer <api_key>. API access requires a Professional or Enterprise subscription. Keep the key server-side; an absent or invalid key returns 401, an ineligible plan returns 403, and a rate-limited request returns 429.
Start with GET /channels to list channels connected to your account. Use an internal channel ID or YouTube channel ID as channel_id when requesting analytics, videos, or audience data. Analytics defaults to a 28-day range and accepts 7d, 28d, 30d, 90d, or 1y; the available history is limited by your plan. Responses include rate-limit headers.
- GET /channels — list connected channels.
- GET /channels/{channelId} — read one connected channel.
- GET /analytics?channel_id={id}&range=28d — read date-bounded channel metrics.
- GET /videos?channel_id={id}&page=1&limit=20 — list a channel's videos.
- GET /audience?channel_id={id} — read the latest audience data.
- GET /competitors — list tracked competitors.