🚀 YouTube Stats API

Your ultimate gateway to YouTube analytics, insights, and data.

--- ## 📖 Overview The **YouTube Stats API** is a powerful, lightning-fast RESTful interface designed to extract rich data from YouTube. Whether you're building a dashboard for creators, a marketing analytics tool, or a social listening platform, this API provides everything you need—from video statistics and channel details to live stream statuses and trending content. *Note: This API is continuously optimized for performance and reliability.* --- ## ✨ Features - **Comprehensive Data Extraction:** Access videos, channels, playlists, comments, and subscriptions. - **Real-Time Insights:** Check if channels are currently live or have upcoming streams. - **Deep Analytics:** Fetch detailed metrics including views, likes, comments, and subscriber counts. - **Global Reach:** Retrieve trending videos and categories based on region codes. - **Accessibility:** Extract available captions for any video. --- ## ⚡ Getting Started ### Base URL When consuming this API via RapidAPI, use the provided host URL. ```text https://<YOUR-RAPIDAPI-HOST> ``` ### Authentication All requests must include your RapidAPI key in the headers. ```http x-rapidapi-host: <YOUR-RAPIDAPI-HOST> x-rapidapi-key: YOUR_API_KEY ``` --- ## 🛣️ API Endpoints All endpoints are scoped under the `/youtube` path. All responses are returned in JSON format. ### 📺 Channels & Users **1. Get Channel Details** Retrieve metadata and statistics for a specific YouTube channel. - **Endpoint:** `GET /youtube/channel` - **Query Params:** - `id` (Required): The YouTube Channel ID (e.g., `UCxxxxxx`) **2. List Subscriptions** Get the list of channels a specific channel is subscribed to. - **Endpoint:** `GET /youtube/subscriptions` - **Query Params:** - `channelId` (Required): The YouTube Channel ID. - `maxResults` (Optional): Default is `20`. ### 🎬 Videos & Content **3. Get Video Details** Fetch comprehensive details for a single video. - **Endpoint:** `GET /youtube/video` - **Query Params:** - `id` (Required): The YouTube Video ID (e.g., `dQw4w9WgXcQ`) **4. Get Video Statistics** Quickly fetch just the metrics (views, likes, comments, favorites) for a video. - **Endpoint:** `GET /youtube/videoStats` - **Query Params:** - `videoId` (Required): The YouTube Video ID. **5. Search Videos** Search for videos across YouTube. **(Available only in ultra, and mega plans)** - **Endpoint:** `GET /youtube/search` - **Query Params:** - `q` (Required): Search query. - `maxResults` (Optional): Default `10`. - `order` (Optional): Default `relevance` (can be `date`, `rating`, `viewCount`). **6. Get Trending Videos** Retrieve the most popular videos in a specific region. - **Endpoint:** `GET /youtube/trending` - **Query Params:** - `country` (Optional): ISO 3166-1 alpha-2 country code (Default: `US`). - `maxResults` (Optional): Default `10`. **7. Get Related Videos** Discover videos related to a specific video. **(Available only in ultra, and mega plans)** - **Endpoint:** `GET /youtube/related` - **Query Params:** - `videoId` (Required): The YouTube Video ID. - `maxResults` (Optional): Default `10`. ### 📑 Playlists **8. Get Playlist Details** Retrieve metadata about a specific playlist. - **Endpoint:** `GET /youtube/playlist` - **Query Params:** - `id` (Required): The Playlist ID (e.g., `PLxxxxxx`). **9. Get Playlist Items** List the videos contained within a playlist. - **Endpoint:** `GET /youtube/playlistItems` - **Query Params:** - `playlistId` (Required): The Playlist ID. - `maxResults` (Optional): Default `20`. ### 💬 Community & Metadata **10. Get Comments** Fetch top-level comments for a specific video. - **Endpoint:** `GET /youtube/comments` - **Query Params:** - `videoId` (Required): The YouTube Video ID. - `maxResults` (Optional): Default `20`. **11. Get Categories** Retrieve a list of video categories available in a specific region. - **Endpoint:** `GET /youtube/categories` - **Query Params:** - `regionCode` (Optional): ISO 3166-1 alpha-2 country code (Default: `US`). **12. Get Captions** List available caption tracks for a video. **(Available only in pro, ultra, and mega plans)** - **Endpoint:** `GET /youtube/captions` - **Query Params:** - `videoId` (Required): The YouTube Video ID. ### 🔴 Live Streams **13. Check Live Status** Check if a specific channel is currently broadcasting live. **(Available only in ultra, and mega plans)** - **Endpoint:** `GET /youtube/live` - **Query Params:** - `channelId` (Required): The YouTube Channel ID. **14. Get Upcoming Live Events** Find upcoming scheduled live streams for a channel. **(Available only in ultra, and mega plans)** - **Endpoint:** `GET /youtube/upcomingLive` - **Query Params:** - `channelId` (Required): The YouTube Channel ID. --- ## 🛠️ Error Handling The API returns standard HTTP status codes to indicate the success or failure of an API request. - `200 OK`: The request was successful. - `400 Bad Request`: Missing required query parameters. - `403 Forbidden`: API quota exceeded or comments are disabled. - `404 Not Found`: The requested resource (video, channel, playlist) does not exist. - `500 Internal Server Error`: An unexpected error occurred on the server. **Example Error Response:** ```json { "success": false, "error": "Video ID is required. Use ?id=dQw4w9WgXcQ" } ``` ---

Built with ❤️ for Developers & Data Enthusiasts.