# FlashData YouTube 비디오 메타 데이터 API

YouTube 비디오 ID에 의해 비디오 메타 데이터를 검색, 채널 세부 사항, 참여 수, 엄지나일, 사용 가능한 형식 및 챕터를 포함하여.

Canonical 참고: https://flashdata.dev/ko/docs/sources/youtube_metadata
평가: 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) · [Bulk](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md)

필수 소스 권한: youtube_metadata

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

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

[검색 및 사용 비디오 metadata](https://flashdata.dev/ko/docs/guides/video-metadata-recipe/reference.md)

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

## 자주 묻는 질문

### Python

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

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_metadata",
    "video_id": "dQw4w9WgXcQ",
    "params": {
        "include_formats": False,
        "include_chapters": True,
    },
}

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_metadata",
  "video_id": "dQw4w9WgXcQ",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
FLASHDATA_JSON
```

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

## 제품 설명

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

### 요청 본문

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | 이름 * | — | youtube_metadata로 설정.  |
| <a id="parameter-video_id"></a> video_id | string | 이름 * | 설정하기 | 11-character YouTube 비디오 ID, FUfGcZ092b0와 같은. 문자, 숫자, 밑줄 및 하이픈을 허용한다. 최소한도 길이: 11. 최대 길이: 11. 본: ^[A-Za-z0-9_-]{11}$ |
| <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-include_formats"></a> params.include_formats | boolean | 의 아니 | true | 사용 가능한 미디어 형식과 그들의 코덱, 해상도 및 비트레이트 정보를 포함.  |
| <a id="parameter-params-include_chapters"></a> params.include_chapters | boolean | 의 아니 | true | 동영상이있을 때 챕터를 포함.  |

<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 = {name: result.get(name) for name in (
    "videoId", "title", "channel", "duration", "hasTranscripts", "transcriptLanguages"
)}
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## 응답 예제

기록된 예; 분야 및 조사는 근원에 달려 있고 요구한 입력.
```json
{
  "source": "youtube_metadata",
  "status": "done",
  "results": [
    {
      "videoId": "dQw4w9WgXcQ",
      "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
      "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick’s ‘Never’ playlist ❤️ #RickAstleyNever\nhttps://linktr.ee/rickastleynever\n\n“Never Gonna Give You Up” was a global smash on its release in July 1987, topping the charts in 25 countries including Rick’s native UK and the US Billboard Hot 100.  It also won the Brit Award for Best single in 1988. Stock Aitken and Waterman wrote and produced the track which was the lead-off single and lead track from Rick’s debut LP “Whenever You Need Somebody”.  The album was itself a UK number one and would go on to sell over 15 million copies worldwide.\n\nThe legendary video was directed by Simon West – who later went on to make Hollywood blockbusters such as Con Air, Lara Croft – Tomb Raider and The Expendables 2.  The video passed the 1bn YouTube views milestone on 28 July 2021.\n\nSubscribe to the official Rick Astley YouTube channel: https://RickAstley.lnk.to/YTSubID\n\nFollow Rick Astley:\nFacebook: https://RickAstley.lnk.to/FBFollowID \nTwitter: https://RickAstley.lnk.to/TwitterID \nInstagram: https://RickAstley.lnk.to/InstagramID \nWebsite: https://RickAstley.lnk.to/storeID \nTikTok: https://RickAstley.lnk.to/TikTokID\n\nListen to Rick Astley:\nSpotify: https://RickAstley.lnk.to/SpotifyID \nApple Music: https://RickAstley.lnk.to/AppleMusicID \nAmazon Music: https://RickAstley.lnk.to/AmazonMusicID \nDeezer: https://RickAstley.lnk.to/DeezerID \n\nLyrics:\nWe’re no strangers to love\nYou know the rules and so do I\nA full commitment’s what I’m thinking of\nYou wouldn’t get this from any other guy\n\nI just wanna tell you how I’m feeling\nGotta make you understand\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\nWe’ve known each other for so long\nYour heart’s been aching but you’re too shy to say it\nInside we both know what’s been going on\nWe know the game and we’re gonna play it\n\nAnd if you ask me how I’m feeling\nDon’t tell me you’re too blind to see\n\nNever gonna give you up\nNever gonna let you down\nNever gonna run around and desert you\nNever gonna make you cry\nNever gonna say goodbye\nNever gonna tell a lie and hurt you\n\n#RickAstley #NeverGonnaGiveYouUp #WheneverYouNeedSomebody #OfficialMusicVideo",
      "channel": "Rick Astley",
      "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "channelUrl": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
      "channelSubscriberCount": 4540000,
      "viewCount": 1816253015,
      "likeCount": 19394097,
      "commentCount": 2400000,
      "uploadDate": "2009-10-25T00:00:00Z",
      "duration": 213,
      "durationString": "3:33",
      "thumbnails": [
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/3.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/3.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/2.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/2.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/1.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/1.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mq3.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/mq3.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mq2.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/mq2.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mq1.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/mq1.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hq3.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hq3.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hq2.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hq2.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hq1.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hq1.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sd3.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sd3.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sd2.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sd2.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sd1.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sd1.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/default.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/mqdefault.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/0.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/0.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEfCKgBEF5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLAy5pvOfmmlRtbC9v1ptqnWgPympA",
          "width": 168,
          "height": 94
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEfCMQBEG5IVfKriqkDEggBFQAAiEIYAXABwAEGuALzGA==&rs=AOn4CLDnaw1sg9xedLybAaLCts8m3KNOlQ",
          "width": 196,
          "height": 110
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEgCPYBEIoBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLAz-h7jukeJwLXsm6EJZ_0FIhWWgw",
          "width": 246,
          "height": 138
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEgCNACELwBSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC8xg=&rs=AOn4CLCqh65ZpY-1S9Y3vJeHWwXLcY0qUw",
          "width": 336,
          "height": 188
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hqdefault.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/sddefault.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hq720.jpg",
          "width": 1280,
          "height": 720
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/hq720.webp",
          "width": null,
          "height": null
        },
        {
          "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        },
        {
          "url": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp",
          "width": 1920,
          "height": 1080
        }
      ],
      "categories": [
        "Music"
      ],
      "tags": [
        "rick astley",
        "Never Gonna Give You Up",
        "nggyu",
        "never gonna give you up lyrics",
        "rick rolled",
        "Rick Roll",
        "rick astley official",
        "rickrolled",
        "Fortnite song",
        "Fortnite event",
        "Fortnite dance",
        "fortnite never gonna give you up",
        "rick roll",
        "rickrolling",
        "rick rolling",
        "never gonna give you up",
        "80s music",
        "rick astley new",
        "animated video",
        "rickroll",
        "meme songs",
        "never gonna give u up lyrics",
        "Rick Astley 2022",
        "never gonna let you down",
        "animated",
        "rick rolls 2022",
        "never gonna give you up karaoke"
      ],
      "ageLimit": 0,
      "isLive": false,
      "wasLive": false,
      "hasTranscripts": true,
      "transcriptLanguages": [
        "fr",
        "no",
        "ab",
        "id",
        "ta",
        "yi",
        "es-419",
        "be",
        "ro",
        "su",
        "zu",
        "ko",
        "to",
        "mk",
        "az",
        "om",
        "dz",
        "ml",
        "gd",
        "nl",
        "sk",
        "bho",
        "ay",
        "or",
        "ceb",
        "bs",
        "new",
        "gn",
        "mn",
        "mg",
        "kha",
        "haw",
        "et",
        "fy",
        "gu",
        "ht",
        "ts",
        "ca",
        "ms",
        "ur",
        "uk",
        "sw",
        "af",
        "tg",
        "ba",
        "oc",
        "st",
        "tr",
        "fa",
        "ny",
        "lo",
        "ti",
        "fo",
        "pa",
        "co",
        "ig",
        "sl",
        "ee",
        "hy",
        "kk",
        "sv",
        "cs",
        "lt",
        "tn",
        "as",
        "ky",
        "ak",
        "ja",
        "eu",
        "mt",
        "de",
        "ar",
        "dv",
        "el",
        "pl",
        "es",
        "pt-BR",
        "lua",
        "vi",
        "ka",
        "sm",
        "jv",
        "os",
        "bo",
        "de-DE",
        "sr",
        "pam",
        "war",
        "sg",
        "kri",
        "ku",
        "ps",
        "xh",
        "ug",
        "lg",
        "te",
        "so",
        "th",
        "sa",
        "iw",
        "tt",
        "zh-Hant",
        "sq",
        "hu",
        "cy",
        "da",
        "yo",
        "en-orig",
        "qu",
        "ss",
        "am",
        "it",
        "bn",
        "gl",
        "kn",
        "bg",
        "ne",
        "hi",
        "my",
        "is",
        "hmn",
        "kl",
        "fil",
        "en",
        "lv",
        "fj",
        "sn",
        "luo",
        "iu",
        "mi",
        "br",
        "km",
        "sd",
        "rn",
        "pt",
        "mfe",
        "ru",
        "si",
        "ve",
        "ha",
        "pt-PT",
        "mr",
        "hr",
        "uz",
        "nso",
        "zh-Hans",
        "ln",
        "gv",
        "la",
        "gaa",
        "lb",
        "tum",
        "tk",
        "crs",
        "aa",
        "fi",
        "rw",
        "eo",
        "ga",
        "wo"
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:45:41.114Z"
}
```

## 응답 분야

| - 연혁 | 유형 | 의 특징 |
| --- | --- | --- |
| source | string | 요청된 API 소스. |
| status | string | 실시간 요청이 성공할 때 완료됩니다. |
| created_at | string | ISO 8601 형식의 응답 생성 시간. |
| usage.credits | number | 요청시 크레딧이 청구되며, 플랜을 기준으로 합니다. |
| results[0].videoId | string | YouTube 비디오 ID. |
| results[0].title | string | 비디오 제목. |
| results[0].description | string | 가득 차있는 영상 묘사. |
| results[0].channel | string | 채널 이름. |
| results[0].channelId | string | 채널 ID. |
| results[0].channelUrl | string | 채널 URL. |
| results[0].channelSubscriberCount | number · nullable | 채널 가입자 수. |
| results[0].viewCount | number · nullable | 보기 수. |
| results[0].likeCount | number · nullable | 숫자처럼. |
| results[0].commentCount | number · nullable | 댓글 개수. |
| results[0].uploadDate | string · nullable | 관련 기사 |
| results[0].duration | number · nullable | 몇 초 안에 비디오 지속. |
| results[0].durationString | string · nullable | 사용 가능한 기간을 지정했습니다. |
| results[0].thumbnails | array | Thumbnail URLs 및 치수. |
| results[0].categories | array | 비디오 카테고리. |
| results[0].tags | array | 동영상 태그. |
| results[0].ageLimit | integer | 제한, 또는 0를 제한할 경우. |
| results[0].isLive | boolean | 비디오가 현재 살고 있는지 여부. |
| results[0].wasLive | boolean | 비디오가 라이브 스트림인지 여부. |
| results[0].hasTranscripts | boolean | 캡션이 사용할 수 있는지 여부. |
| results[0].transcriptLanguages | array | 사용 가능한 캡션 언어 코드. |
| results[0].formats | array · optional | include_formats가 true일 때 사용 가능한 미디어 형식. |
| results[0].chapters | array · optional | 장 제목, start_time 및 end_time 초, 요청 및 사용할 때. |

- 사용 가능한 수치는 null일 수 있습니다. 형식과 장은 요청된 옵션과 비디오의 사용 가능한 데이터에 달려 있습니다.

## 응답 형식

응답은 기본적으로 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)
- [Bulk 처리 API](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md)
- [이 소스의 Bulk 워크플로우 구축](https://flashdata.dev/ko/docs/reference/bulk-processing/reference.md?source=youtube_metadata#playground)
- [고객 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 Transcript API](https://flashdata.dev/ko/docs/sources/youtube_transcript/reference.md)
- [YouTube Download API](https://flashdata.dev/ko/docs/sources/youtube_download/reference.md)
