YouTube API

공개 YouTube 데이터 API

Name: YouTube Data API
Brand: SocialCrawl
Availability: InStock

SocialCrawl API 키로 공개 YouTube 데이터를 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기 동작 방식 직접 호출

/v1/youtube

활성 엔드포인트는 28개입니다.

GET /v1/youtube/channel
GET /v1/youtube/profile/full
GET /v1/youtube/channel/videos
GET /v1/youtube/video
GET /v1/youtube/video/comments
GET /v1/youtube/video/transcript
GET /v1/youtube/search
GET /v1/youtube/search/advanced
GET /v1/youtube/playlist
GET /v1/youtube/shorts/trending

YouTube 엔드포인트

공개 YouTube 읽기 엔드포인트는 28개입니다. 채널, 영상, 댓글, 대본, 재생목록, 검색, 쇼츠 표면을 제공합니다. 데이터 API만 지원합니다.

채널

1 크레딧

/v1/youtube/channel

공개 채널 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

channelId, handle, url, hl

전체 프로필

5 크레딧

/v1/youtube/profile/full

공개 전체 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, channelId, url, posts

채널 영상

1 크레딧

/v1/youtube/channel/videos

공개 채널 영상 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

channelId, handle, sort, continuationToken

영상

1 크레딧

/v1/youtube/video

공개 영상 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url, language, hl

영상 댓글

1 크레딧

/v1/youtube/video/comments

공개 댓글 데이터를 반환합니다. 작성자, 본문, 참여 지표가 포함됩니다.

url, continuationToken, order, searchTerm, format

영상 대본

3 크레딧

/v1/youtube/video/transcript

공개 대본 또는 자막 데이터를 반환합니다. 없으면 환불될 수 있습니다.

url, language

검색

1 크레딧

/v1/youtube/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, uploadDate, sortBy, type, duration

고급 검색

1 크레딧

/v1/youtube/search/advanced

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, order, duration, event_type, license

재생목록

1 크레딧

/v1/youtube/playlist

공개 재생목록 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

playlist_id, cursor, channel_id

쇼츠 트렌딩

5 크레딧

/v1/youtube/shorts/trending

공개 쇼츠 트렌딩 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

see docs

YouTube API28개 엔드포인트 지원

문서 보기

YouTube 채널의 공개 프로필을 돌려줍니다: YouTube가 공개하는 구독자 수(author.followers; 1,000명 이상이면 유효숫자 세 자리로 반올림되고 author.ext.followers_approximate가 true), 총 영상 수, 총 조회수, 설명, 배너 URL, 아바타 URL.

handle, 채널 id, 채널 URL 중 하나로 영상을 가져오기 전에 계정을 훑어볼 때 사용하세요.

1크레딧

GET/v1/youtube/channel?handle=MrBeast

channelIdhandleurlhlforUsername

$ curl https://www.socialcrawl.dev/v1/youtube/channel?handle=MrBeast \
    -H "x-api-key: sc_YOUR_API_KEY"

대기 중

// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

YouTube API 동작 방식

YouTube도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/youtube/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 계정을 확인한 뒤 목록을 보고 필요한 게시물만 깊게 읽습니다.

01계정

GET /v1/youtube/channel

Author 형태 프로필입니다.

핸들 또는 id를 한 번 확정합니다.

02목록

GET /v1/youtube/profile/full

최근 공개 항목의 PostList입니다.

라우트가 지원하면 cursor 또는 after로 페이지를 넘깁니다.

03항목

GET /v1/youtube/channel/videos

URL 또는 id 기준 전체 Post입니다.

목록 행만으로 부족할 때 사용합니다.

04댓글

GET /v1/youtube/video

플랫폼이 제공하는 CommentList입니다.

스레드가 중요할 때만 확장합니다.

요청

GET /v1/youtube/channel
  ?handle=example
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

응답 봉투

{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authorchannel

id, username, display_name, avatar_url, bio, followers, url, ext

PostList / Postprofile/full

items[].post에 id, url, content, engagement, author, published_at, ext

CommentListchannel/videos

댓글 라우트가 있을 때 items[]에 author, content.text, engagement, published_at

Search / Mediavideo

검색 결과, 미디어 메타데이터, 대본 등 라우트별 필드

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

엣지 수신

Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

검증 후 차감

레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

캐시 또는 수집

platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

정규화 후 반환

upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

표준 라이브 미스: 티어 비용(보통 1 크레딧)
고급 읽기: 보통 5 크레딧
프리미엄 읽기: 보통 10 크레딧
종량제 라우트: 문서화된 최소 바닥
캐시 히트: 0 크레딧
빈 응답·하드 실패: 자동 환불
잘못된 파라미터: 400, 미과금
크레딧 부족: 402, 미과금
비활성 라우트: 503, 미과금

데이터 수집 방식

YouTube은 SocialCrawl의 공개 읽기 데이터입니다. 공유 스키마로 정규화하므로 별도 OAuth를 배울 필요가 없습니다.

이 API에서의 YouTube

레지스트리에 노출된 공개 YouTube 표면입니다. 연구·모니터링·제품 작업을 위한 읽기 전용입니다.

SocialCrawl 접근 방식

하나의 게이트웨이 뒤에서 소셜 읽기 upstream을 호출합니다. 등록된 두꺼운 라우트는 Prism 컴포지트로 단계를 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. Author / Post / Comment 리프를 공유합니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 수신함은 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다.

필드 매핑

public profile / channel→ author.*프로필 식별자와 카운터

public post / media→ post.* / items[].post게시물 본문과 참여 지표

comment page / tree→ CommentList items[]댓글 또는 검색 결과

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

28active YouTube endpoints in the registry

1 / 5 / 10표준·고급·프리미엄 크레딧 단계

채널 인텔리전스와 영상 VoC

호출은 YouTube 프로필, 콘텐츠 목록, 검색, 심화 경로에 집중됩니다. 채널-영상-댓글-대본 체인을 크레딧 가격으로 제공합니다. 이 읽기에는 별도 YouTube Data API 프로젝트가 필요하지 않습니다.

상세 읽기는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 컴포지트는 더 느린 경로입니다.

YouTube API 활용 사례

YouTube 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

소셜 리스닝날짜 구간 고급 검색과 검색 결과의 댓글을 제공합니다.

댓글 수집영상의 댓글 스레드와 그 아래 답글을 페이지 단위로 조회합니다.

크리에이터 분석채널 레코드와 영상, 쇼츠를 조회하고 영상별 통계를 함께 반환합니다.

인플루언서 검색채널 검색과 해석을 제공하고 크리에이터가 실제로 발행하는 영상과 쇼츠를 조회합니다.

계정 통합 조회채널과 영상 목록을 조회합니다. 계정이 선점만 된 상태인지 실제로 활동 중인지 확인하는 근거입니다.

시장 조사날짜 구간 고급 검색과 리뷰 및 비교 영상의 댓글 스레드를 제공합니다.

영상 자막커버리지가 가장 넓은 레인입니다. URL 단건 조회와 영상 ID 묶음 조회를 지원합니다. 보유 플랫폼 중 가장 넓지만 전체 영상을 포괄하지는 않습니다.

뉴스·공개출처 모니터링날짜 구간 고급 검색과 그 아래 댓글을 제공하며 사건의 영상 보도를 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

모니터링 잡

Python, cron, Slack 봇

YouTube 프로필과 피드를 폴링합니다. 참여 속도가 뛰면 알립니다.

리서치·VoC

Node, 노트북, BI 적재

YouTube에서 검색 후 게시물을 확장해 브랜드·제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

해석-목록-상세를 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

라이브 미스는 티어별 크레딧을 사용합니다. 캐시 히트는 무료입니다. 빈 응답과 하드 실패는 환불됩니다.

curl "https://www.socialcrawl.dev/v1/youtube/channel?handle=example" \
  -H "x-api-key: sc_your_api_key_here"

curl "https://www.socialcrawl.dev/v1/youtube/profile/full?handle=example" \
  -H "x-api-key: sc_your_api_key_here"

SocialCrawl의 YouTube

카탈로그 전 구간과 같은 키

플랫폼 문서 API 키 받기

엔드포인트

YouTube API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ChannelGet YouTube channel info Channel VideosList YouTube channel videos VideoGet YouTube video details VideosBatch get YouTube video details (up to 1000)ChannelsBatch get YouTube channel details (up to 1000)TranscriptsUp to 100 YouTube video ids → one transcript per row, failed ids refunded.Video SponsorsDetect sponsors of a YouTube video Video CommentsList YouTube video comments Video Comment RepliesList YouTube comment replies SearchSearch YouTube Channel ShortsList YouTube channel shorts Community PostGet YouTube community post PlaylistGet YouTube playlist Search HashtagSearch YouTube by hashtag Shorts TrendingGet trending YouTube shorts Video TranscriptGet YouTube video transcript Channel PlaylistsList a YouTube channel's playlists Channel LivesList a YouTube channel's live streams Channel Community PostsList a YouTube channel's community posts Videos TrendingGet trending YouTube videos Playlist ItemsList the videos in a YouTube playlist Search AdvancedAdvanced YouTube video search Search SuggestionsGet YouTube search suggestions Video AudioGet a YouTube video's audio file streams Video FilesGet a YouTube video's video file streams Video SubtitlesGet a YouTube video's subtitle files Video ThumbnailsGet a YouTube video's thumbnail files Profile FullYouTube profile, recent posts, and computed analytics in one call.

비교

SocialCrawl과 공식 YouTube Data API v3, 뭐가 다른가요?

같은 YouTube 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

항목	SocialCrawl	공식 YouTube Data API v3
인증	x-api-key 헤더 하나면 돼요	Google Cloud API 키가 필요하고, 비공개 데이터는 OAuth까지 거쳐요
시작과 심사	가입하고 1분 안에 바로 호출할 수 있어요	Google Cloud 프로젝트를 만들어야 하고, 쿼터 증설은 심사를 받아야 해요
요청 한도	일일 쿼터 걱정 없이 쓴 만큼 크레딧으로 결제해요	기본 하루 10,000 쿼터 단위이고, 검색 한 번에 100 단위가 소진돼요
데이터 범위	채널, 영상, Shorts, 댓글, 재생목록, 커뮤니티 포스트, 트렌딩 Shorts, 자막까지 받아볼 수 있어요	커뮤니티 포스트는 안 나오고, 자막은 내 영상만 받을 수 있어요
응답 스키마	51개 플랫폼이 같은 통합 JSON 스키마를 써요	YouTube 전용 리소스 구조예요
요금	요청당 1 크레딧부터, 100 크레딧 무료로 시작해요	일일 쿼터 안에서는 무료예요
유지보수	YouTube 화면이 바뀌어도 통합 스키마가 그대로 유지돼요	Google 공식 지원과 안정적인 버전 관리가 강점이에요

인증

SocialCrawl

x-api-key 헤더 하나면 돼요

공식 YouTube Data API v3

Google Cloud API 키가 필요하고, 비공개 데이터는 OAuth까지 거쳐요

시작과 심사

SocialCrawl

가입하고 1분 안에 바로 호출할 수 있어요

공식 YouTube Data API v3

Google Cloud 프로젝트를 만들어야 하고, 쿼터 증설은 심사를 받아야 해요

요청 한도

SocialCrawl

일일 쿼터 걱정 없이 쓴 만큼 크레딧으로 결제해요

공식 YouTube Data API v3

기본 하루 10,000 쿼터 단위이고, 검색 한 번에 100 단위가 소진돼요

데이터 범위

SocialCrawl

채널, 영상, Shorts, 댓글, 재생목록, 커뮤니티 포스트, 트렌딩 Shorts, 자막까지 받아볼 수 있어요

공식 YouTube Data API v3

커뮤니티 포스트는 안 나오고, 자막은 내 영상만 받을 수 있어요

응답 스키마

SocialCrawl

51개 플랫폼이 같은 통합 JSON 스키마를 써요

공식 YouTube Data API v3

YouTube 전용 리소스 구조예요

요금

SocialCrawl

요청당 1 크레딧부터, 100 크레딧 무료로 시작해요

공식 YouTube Data API v3

일일 쿼터 안에서는 무료예요

유지보수

SocialCrawl

YouTube 화면이 바뀌어도 통합 스키마가 그대로 유지돼요

공식 YouTube Data API v3

Google 공식 지원과 안정적인 버전 관리가 강점이에요

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

YouTube 데이터를 공식 API 쿼터 없이 가져올 수 있나요?

SocialCrawl API 키만 있으면 /v1/youtube/* 엔드포인트를 바로 호출할 수 있어요. Google Cloud 프로젝트나 OAuth 없이, 쿼터 단위 없이, 크레딧 기반으로 사용량만큼만 결제돼요.

SocialCrawl의 YouTube API는 어떤 데이터를 받아볼 수 있나요?

채널, 영상, 댓글, 댓글 답글, 검색 결과, Shorts, 해시태그 검색, 재생목록, 채널 라이브 방송, 커뮤니티 포스트(단일 포스트는 물론 채널 피드 전체), 트렌딩 Shorts, 자막까지 총 28개 엔드포인트를 제공해요. 모두 통합 스키마로 정리된 JSON 응답이에요.

공식 YouTube Data API v3과 어떤 점이 다른가요?

Data API v3은 하루 10,000 쿼터 단위로 제한되고 일부 리소스는 OAuth를 요구해요. SocialCrawl은 요청당 1~10 크레딧이 차감되고 일별 쿼터가 없으며, 공식 API가 제공하지 않는 Shorts와 자막도 받아볼 수 있어요.

YouTube API 요금은 얼마인가요?

대부분의 엔드포인트는 요청당 1 크레딧이에요(채널, 영상, 검색, 댓글, 재생목록). 트렌딩 Shorts는 5 크레딧, 영상 자막은 10 크레딧이고, 신규 가입 시 100 크레딧이 무료로 제공돼요.

YouTube 데이터를 수집해도 법적으로 괜찮나요?

SocialCrawl은 YouTube의 공개 페이지만 가져와요. 누구나 볼 수 있는 데이터이지만, 사용 목적이 YouTube 약관과 개인정보 관련 법령에 부합하는지는 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.

프로덕션에서도 SocialCrawl YouTube API를 쓸 수 있나요?

네, 안정적인 응답 시간과 업스트림 자동 재시도, YouTube UI가 바뀌어도 깨지지 않는 통합 스키마를 제공해요. 안심하고 프로덕션에 붙이실 수 있어요.

YouTube 스크래핑 API는 어떤 걸 쓰는 게 좋아요?

공개 데이터 수집이라면 SocialCrawl이 잘 맞아요. 채널, 영상, Shorts, 댓글, 재생목록, 커뮤니티 포스트, 트렌딩 Shorts, 자막까지 28개 엔드포인트를 요청당 1~10 크레딧으로 호출할 수 있고, 일일 쿼터가 따로 없어요. 가입하면 신용카드 없이 100 크레딧을 무료로 받아요. 내 채널 관리나 업로드가 목적이라면 공식 Data API v3이 맞아요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

YouTube API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요