# Youtube Channel

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/youtube/channel` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/youtube-channel |

## Description

Use the YouTube Channel API to extract detailed video data from EminemMusic and drive informed business decisions.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/youtube/channel' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "videos": [
    {
      "url": "https://www.youtube.com/watch?v=S9bCLPwzSC0",
      "title": "Eminem - Mockingbird [Official Video]",
      "views": "636M views",
      "thumbnailUrl": "https://i.ytimg.com/vi/S9bCLPwzSC0/hqdefault.jpg",
      "publishedDate": "14 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=8CdcCD5V-d8",
      "title": "Eminem - Venom",
      "views": "549M views",
      "thumbnailUrl": "https://i.ytimg.com/vi/8CdcCD5V-d8/hqdefault.jpg",
      "publishedDate": "4 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=lexLAjh8fPA",
      "title": "Eminem - Like Toy Soldiers (Official Music Video)",
      "views": "529M views",
      "thumbnailUrl": "https://i.ytimg.com/vi/lexLAjh8fPA/hqdefault.jpg",
      "publishedDate": "14 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=j5-yKhDd64s",
      "title": "Eminem - Not Afraid",
      "views": "1.5B views",
      "thumbnailUrl": "https://i.ytimg.com/vi/j5-yKhDd64s/hqdefault.jpg",
      "publishedDate": "12 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=YVkUvmDQ3HY",
      "title": "Eminem - Without Me (Official Music Video)",
      "views": "1.4B views",
      "thumbnailUrl": "https://i.ytimg.com/vi/YVkUvmDQ3HY/hqdefault.jpg",
      "publishedDate": "13 years ago"
    },
    {
      "url": "https://www.youtube.com/watch?v=XbGs_qK2PQA",
      "title": "Eminem - Rap God (Explicit)",
      "views": "1.3B views",
      "thumbnailUrl": "https://i.ytimg.com/vi/XbGs_qK2PQA/hqdefault.jpg",
      "publishedDate": "8 years ago"
    }
  ],
  "channelUrl": "https://www.youtube.com/@eminem",
  "channelName": "EminemMusic"
}
```

## Documentation

## Overview
Use the YouTube Channel API to extract detailed video data from EminemMusic and drive informed business decisions.

## Quickstart
```
GET https://api.piloterr.com/v2/youtube/channel?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Youtube Channel data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Youtube without maintaining scrapers
- Power internal dashboards and workflow automations with live Youtube data