# FlashData YouTube Channel API

YouTube 채널 프로파일을 검색하고 최근의 비디오를 처리하여 가입자 수, 채널 이미지 및 비디오 세부 사항을 포함하여 검색합니다.

Canonical 참고: https://flashdata.dev/ko/docs/sources/youtube_channel
평가: 2026-10-23

끝점: POST https://data.flashdata.dev/v1/queries/realtime
인증: X-API-Key: YOUR_API_KEY
모드: [Realtime](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ko/docs/reference/batch-and-bulk/reference.md#batch)

필수 소스 권한: youtube_channel

YOUR_API_KEY를 API 키로 교체하여 소스 권한 및 사용 가능한 크레딧을 제공합니다. 서버 또는 에이전트 호스트에 대한 요청을 실행합니다.

[인증 설정](https://flashdata.dev/ko/docs/guides/headers-and-authentication/reference.md)

[채널 및 최근 동영상 작업](https://flashdata.dev/ko/docs/guides/youtube-data-guide/reference.md#channel)

<a id="quickstart"></a>

## 자주 묻는 질문

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_channel",
    "handle": "@jawed",
    "params": {
        "video_limit": 10,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_channel",
  "handle": "@jawed",
  "params": {
    "video_limit": 10
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## 제품 설명

<a id="parameters-group-0"></a>

### 요청 본문

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | 이름 * | — | youtube_channel로 설정.  |
| <a id="parameter-handle"></a> handle | string | 이름 * | 설정하기 | @jawed와 같은 채널 손잡이. @ 접두사는 선택 사항입니다. 최소한도 길이: 1. 최대 길이: 100. |
| <a id="parameter-params"></a> params | object | 의 아니 | {} | 이 요구를 위한 Settings.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | 의 아니 | 설정하기 | Async 및 배치만. 공공 HTTPS 완료 URL 포트에 443, 최대 2,048 문자. 사용자 자격 또는 URL 파편이 없습니다. Omit, null 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.  |

<a id="parameters-group-1"></a>

### 영상 선택

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-video_limit"></a> params.video_limit | integer | 의 아니 | 20 | 최대 동영상이 포함되어 있습니다. Fewer는 사용할 수 있습니다. 최소: 1. 최대: 100. |

<a id="response"></a>

## 결과보기

response.json로 성공적인 JSON 응답을 저장하십시오. read-response.py로 저장하고 python read-response.py를 실행하십시오. Python의 표준 라이브러리를 사용하고 새로운 요청을 만들 수 있습니다.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = {
    "channelId": result.get("channelId"),
    "name": result.get("name"),
    "videos": [
        {"videoId": item.get("videoId"), "title": item.get("title")}
        for item in result.get("videos", [])
    ],
}
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## 응답 예제

기록된 예; 분야 및 조사는 근원에 달려 있고 요구한 입력.
```json
{
  "source": "youtube_channel",
  "status": "done",
  "results": [
    {
      "channelId": "UC4QobU6STFB0P71PMvOGN5A",
      "channelHandle": "@jawed",
      "name": "jawed",
      "description": "",
      "subscriberCount": 6580000,
      "videoCount": 1,
      "viewCount": null,
      "avatarUrl": "https://yt3.googleusercontent.com/uI3VE4PVqvCy0xnWLqMJnEzyBUm3T8VHOCp4ee-1RxdHqKXCdUE_qXYQnpf9AfuEoIPactVyDhM=s0",
      "bannerUrl": null,
      "channelUrl": "https://www.youtube.com/channel/UC4QobU6STFB0P71PMvOGN5A",
      "videos": [
        {
          "videoId": "jNQXAC9IVRw",
          "title": "Me at the zoo",
          "duration": 19,
          "viewCount": 431000000,
          "uploadDate": null,
          "thumbnail": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE2COADEI4CSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgBvgKAAvABigIMCAAQARhVIFkoZTAP&rs=AOn4CLDkGJrAGBspJ5G6u9b7tutsHbloEg"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:41:47.218Z"
}
```

## 응답 분야

| - 연혁 | 유형 | 의 특징 |
| --- | --- | --- |
| source | string | 요청된 API 소스. |
| status | string | 실시간 요청이 성공할 때 완료됩니다. |
| created_at | string | ISO 8601 형식의 응답 생성 시간. |
| usage.credits | number | 요청시 크레딧이 청구되며, 플랜을 기준으로 합니다. |
| results[0].channelId | string | 채널 ID. |
| results[0].channelHandle | string | 채널 손잡이. |
| results[0].name | string | 채널 이름. |
| results[0].description | string | 채널 설명. |
| results[0].subscriberCount | number · nullable | 구독자 수. |
| results[0].videoCount | number · nullable | 총 채널 비디오 카운트. |
| results[0].viewCount | number · nullable | 사용할 때 채널 보기 수. |
| results[0].avatarUrl | string · nullable | 채널 아바타 URL. |
| results[0].bannerUrl | string · nullable | 채널 배너 URL. |
| results[0].channelUrl | string | 채널 페이지 URL. |
| results[0].videos | array | 최근 동영상, 최대 video_limit 항목. |
| results[0].videos[].videoId | string | 비디오 ID. |
| results[0].videos[].title | string | 비디오 제목. |
| results[0].videos[].duration | number · nullable | 몇 초 동안 지속됩니다. |
| results[0].videos[].viewCount | number · nullable | 보기 수. |
| results[0].videos[].uploadDate | string · nullable | 관련 기사 |
| results[0].videos[].thumbnail | string · nullable | 비디오 썸네일 URL. |

- 채널 통계 및 이미지는 사용할 수 없습니다. videoCount는 채널을 설명합니다. 비디오 어레이는 요청한 최근 비디오 만 포함합니다.

## 응답 형식

응답은 기본적으로 JSON를 사용합니다. 이 선택적인 우두머리를 가진 다른 체재를 선택하십시오.

- Accept: application/json (기본 정보) 또는 text/plain. 일반 텍스트는 읽기 가능한 동일한 필드를 제공하며 들여쓰는 레이아웃을 나타냅니다.
- X-Respond-With: markdown. 원래 필드에 대 한 unset를 남겨 주세요. Markdown는 응답 체재로 작동합니다.

Markdown는 실시간 쿼리 및 완료 결과를 위해 사용할 수 있습니다.

아래 필드는 기본 JSON 응답을 설명합니다.

[요청 및 응답 형식 예](https://flashdata.dev/ko/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API 기초

이 소스의 매개 변수를 사용 위의 요청 빌더와 예제. Python 및 cURL 예제를 공유 제출, 상태 및 결과 단계에 사용됩니다. Batch 바디는 쿼리를 포함하는 JSON 객체입니다. 각 항목은 자신의 직업 ID를 반환합니다.

- [Async 요청 및 영수증](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [작업 상태 확인](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [완료된 결과를 읽으십시오](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON 요청](https://flashdata.dev/ko/docs/reference/batch-and-bulk/reference.md#batch)
- [고객 OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## 보상 알림

- [완료 webhooks를 수신하고 확인](https://flashdata.dev/ko/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## 관련 상품

- [오류와 상태 코드](https://flashdata.dev/ko/docs/errors/reference.md#status-codes)
- [재발행](https://flashdata.dev/ko/docs/errors/reference.md#retries)

## 관련 API

- [YouTube 비디오 메타 데이터 API](https://flashdata.dev/ko/docs/sources/youtube_metadata/reference.md)
- [YouTube Search API](https://flashdata.dev/ko/docs/sources/youtube_search/reference.md)
