YouTube 데이터 API
YouTube 채널, 영상, 댓글 스레드와 키워드 검색을 정규화된 JSON을 반환하는 하나의 REST 인터페이스로.
- 케이퍼빌리티 패밀리 6개
- 문서화된 엔드포인트 6개
케이퍼빌리티 패밀리별 엔드포인트 목록
계정 신원: 프로필 조회 — 소개, 인증, 오디언스 필드를 정규화된 JSON으로 반환합니다.
| 메서드 | 경로 | 케이퍼빌리티 |
|---|---|---|
| GET | /v1/youtube/users/{username} | youtube.profile |
게시·활동 피드: 계정, 해시태그, 음악 페이지가 올린 콘텐츠를 순서대로 반환합니다.
| 메서드 | 경로 | 케이퍼빌리티 |
|---|---|---|
| GET | /v1/youtube/users/{username}/posts | youtube.user_posts |
단일 콘텐츠 조회: 게시물 1건과 그에 붙은 댓글·좋아요·미디어를 정규화해 반환합니다.
| 메서드 | 경로 | 케이퍼빌리티 |
|---|---|---|
| GET | /v1/youtube/posts/{id} | youtube.post |
단일 콘텐츠 조회: 게시물 1건과 그에 붙은 댓글·좋아요·미디어를 정규화해 반환합니다.
| 메서드 | 경로 | 케이퍼빌리티 |
|---|---|---|
| GET | /v1/youtube/posts/{id}/comments | youtube.comments |
검색과 트렌드: 콘텐츠·계정 키워드 검색, 인기 검색어, 트렌드 주제.
| 메서드 | 경로 | 케이퍼빌리티 |
|---|---|---|
| GET | /v1/youtube/search/posts | youtube.search_posts |
검색과 트렌드: 콘텐츠·계정 키워드 검색, 인기 검색어, 트렌드 주제.
| 메서드 | 경로 | 케이퍼빌리티 |
|---|---|---|
| GET | /v1/youtube/search/users | youtube.search_users |
자주 묻는 질문
YouTube 데이터 API 알아보기
YouTube 데이터 API란?
YouTube 데이터 API는 YouTube를 위한 FetchPI의 읽기 인터페이스입니다. 문서화된 REST 엔드포인트가 공개적으로 이용 가능한 YouTube 데이터를 구조화된 JSON으로 반환합니다. 페이지를 파싱하거나 플랫폼 전용 스크레이퍼를 유지하는 대신, 엔드포인트를 호출해 안정적인 필드 이름을 가진 정규화 응답을 읽으면 됩니다. 그 스키마 형태는 모든 FetchPI 플랫폼과 동일합니다. 문서화된 6개 엔드포인트는 모두 케이퍼빌리티 패밀리로 묶여 있고, 각 패밀리에는 참조 페이지·파라미터 표·예시가 있습니다.
YouTube 데이터 API로 어떤 데이터를 가져올 수 있나요?
API는 위 표에 나열된 YouTube 케이퍼빌리티 패밀리를 다룹니다. 6개 패밀리, 6개 엔드포인트이며 각각 파라미터와 응답 스키마가 문서화되어 있습니다. 대표적인 용도는 프로필 보강, 게시물·댓글 수집, 팔로워 그래프 분석, 키워드 모니터링, 트렌드 추적입니다. 패밀리가 반환하는 정확한 필드는 해당 케이퍼빌리티 페이지에 문서화되어 있고, 계약에 없는 데이터 유형을 API는 약속하지 않습니다.
YouTube에 현재 공개된 케이퍼빌리티 패밀리:
- profile
- user_posts
- post
- comments
- search_posts
- search_users
YouTube 데이터 API 사용 방법
처음부터 첫 응답까지 세 단계입니다.
1단계 — 무료 계정 만들기
콘솔에서 가입하세요. 워크스페이스가 자동 생성되고, 가입 시 첫 호출에 쓸 무료 크레딧이 지급됩니다.
2단계 — API 키 발급
콘솔에서 키를 만들고, 모든 요청에 표준 Authorization: Bearer 헤더로 담아 보냅니다.
3단계 — 엔드포인트 호출
GET /v1/youtube/users/{username} 같은 문서화된 엔드포인트로 시작해 응답에서 정규화된 JSON을 읽으세요. 아래 복사해 쓸 수 있는 예시는 계약의 데모 값을 사용합니다.
curl -H "Authorization: Bearer $FETCHPI_API_KEY" \
"https://fetchpi.com/v1/youtube/users/newdev"데이터 최신성 동작 방식
모든 엔드포인트는 데이터 API 전체가 공유하는 최신성 파라미터를 받습니다. cache는 업스트림에 접촉하지 않고 저장된 스냅샷으로 답하고, live는 더 최신 데이터를 조회하며 추가 크레딧이 붙을 수 있고, max_age는 허용 가능한 데이터 나이를 초 단위로 제한합니다. 응답의 meta 블록은 각 응답을 만든 모드·데이터 나이·서빙 계층을 보고하므로, 다운스트림 시스템은 최신성을 추측이 아니라 사실로 다룹니다. API가 약속하지 않는 것은 업스트림의 실시간 상태입니다. meta 블록이 실제로 받은 것에 대한 정직한 보고입니다.
직접 만드는 스크레이퍼와 YouTube 데이터 API 비교
직접 만든 YouTube 스크레이퍼는 잘 동작하는 경우의 소유자이기도 합니다. 페이지 구조는 바뀌고, 봇 대책은 강해지고, 파서 수정은 모두 일정에 올라옵니다. 데이터 API는 그 유지 보수를 계약으로 바꿉니다. 문서화된 요청·응답 스키마, 데이터 없음·레이트 리밋 상황의 공개된 오류 코드, 모든 FetchPI 플랫폼에서 재사용되는 하나의 통합 형태입니다. 범위는 양쪽 모두 정직합니다. API는 공개 데이터만 다루고, 계정 자격 증명을 요구하지 않으며, YouTube의 공식 제품이 아닙니다.
YouTube 데이터에 FetchPI를 선택하는 이유
홍보 문구가 아니라 통합 과정에서 드러나는 세 가지 이유입니다.
- 하나의 정규화 스키마 — YouTube 응답은 모든 FetchPI 플랫폼과 같은 필드 구조를 쓰므로, 멀티 플랫폼 파이프라인은 한 번만 파싱합니다.
- 투명한 최신성 — 모든 응답이 최신성 모드·데이터 나이·서빙 계층을 보고합니다. 요청마다 cache 또는 live를 선택하고 그에 맞게 지불합니다.
- 사용량 기반 과금 — 공개된 케이퍼빌리티 단가의 요청 단위 크레딧. 좌석 요금도 정액제도 없고, meta 블록이 각 호출의 소비를 보고합니다.
비용과 제한
요청 단위로 크레딧 결제됩니다. 케이퍼빌리티별 공개된 단가가 있고, 캐시 응답은 라이브 조회보다 저렴하며, 충전은 셀프서비스입니다. 엔드포인트에는 레이트 리밋이 있어 제한된 호출은 조용히 실패하는 대신 문서화된 RATE_LIMIT_EXCEEDED 오류를 반환하고, 응답의 meta 블록이 소비된 크레딧을 보고합니다. 케이퍼빌리티별 현재 가격은 요금 페이지에, 오류 코드와 레이트 리밋의 전체 참조는 문서에 있습니다.