API 목록으로 돌아가기
YouTube public data

YouTube Public Data API

지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.

사용 가능한 YouTube API

채널·동영상 직접 조회, 채널 기반 동영상·쇼츠 수집, 공개 댓글, 키워드·해시태그 탐색, 제공되는 스크립트 텍스트 중에서 선택하세요.

어떤 YouTube 데이터를 가져올 수 있나요?

SocQ는 지원되는 공개 YouTube 결과를 정규화된 레코드로 변환해 정보 보강, 모니터링, 리서치, 콘텐츠 분석, 리포트에 활용할 수 있게 합니다.

채널 프로필

채널 식별 정보, 소개, 공개 이미지, 인증 여부, 공개된 구독자 수·동영상 수·총 조회수를 가져옵니다.

동영상·쇼츠 메타데이터

제목, 설명, 채널 정보, 썸네일, 길이, 게시 관련 데이터, 공개된 참여 지표를 수집합니다.

공개 댓글 반응

공개된 댓글 텍스트, 작성자 정보, 좋아요 수, 답글 수, 동영상 참조, 부모 댓글과의 관계를 수집합니다.

탐색과 스크립트

키워드로 공개 일반 동영상을 검색하고, 해시태그 피드에 연결된 동영상을 수집하며, 알고 있는 URL의 자막을 일반 텍스트로 가져옵니다.

SocQ vs YouTube Data API

SocQ는 지원되는 공개 데이터 수집과 정규화된 결과에 초점을 맞춥니다. 공식 OAuth, 채널 관리, 승인된 작업이 필요하다면 YouTube Data API가 적합합니다.

기능SocQYouTube Data API
주요 용도지원되는 공개 데이터 수집 및 정규화공식 플랫폼 연동 및 승인된 리소스
인증SocQ API 키작업에 따라 Google OAuth 또는 API 자격 증명
콘텐츠 관리YouTube 콘텐츠를 생성·수정·삭제하거나 좋아요·댓글을 남기는 등의 관리를 하지 않음승인된 범위 내의 작업 지원
비공개 또는 제한된 데이터지원하지 않음부여된 권한과 플랫폼 정책이 허용하는 데이터로 제한
응답 형식정규화된 SocQ 레코드YouTube API 고유 리소스

YouTube API 작동 방식

8개 엔드포인트 모두 비동기 제출, 폴링, 커서 페이지네이션의 같은 흐름으로 동작합니다.

  1. 1. 공개 입력 제출

    지원되는 채널 URL, 동영상 URL, 키워드 검색어, 해시태그와 엔드포인트별 선택 필터를 POST합니다.

  2. 2. 작업 폴링

    반환된 작업 ID로 처리가 성공하거나 실패할 때까지 조회하고, 일시적인 부하 응답을 받으면 백오프를 적용합니다.

  3. 3. 읽기와 페이지네이션

    data.results.items에서 정규화된 레코드를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.

API 요청 한 번으로 시작하기

SocQ API 키로 인증합니다. 이 요청은 공개 채널 프로필을 가져오며, 동영상·댓글·쇼츠·키워드 또는 해시태그 탐색·스크립트는 다른 엔드포인트를 선택하세요.

curl -X POST "https://api.socq.ai/v1/youtube/channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

YouTube API 주요 활용 사례

크리에이터·채널 리서치

공개 채널 프로필, 일반 동영상, 쇼츠를 결합해 디렉터리 정보를 보강하고 비교 분석합니다.

콘텐츠·반응 모니터링

선택한 동영상의 메타데이터, 공개 댓글 토론, 수집 시점의 참여 지표 스냅샷을 추적합니다.

주제 탐색

키워드나 해시태그 피드로 공개 동영상을 검색한 뒤, 선택한 URL의 정보를 보강하거나 제공되는 스크립트 텍스트를 가져옵니다.

데이터 파이프라인

정규화된 레코드를 데이터 웨어하우스, 검수 도구, 분류기, 검색 인덱스, 리포트 시스템으로 전달합니다.

제한 사항과 공개 데이터 정책

YouTube 공개 결과는 수시로 바뀌며, 현재의 공개 범위, 분류, 지역별 제공 여부, 공개된 자막·댓글 접근 가능 여부에 따라 달라집니다.

  • 비공개, 삭제됨, 멤버 전용, 지역 제한, 연령 제한 등 접근할 수 없는 콘텐츠는 레코드가 생성되지 않을 수 있습니다.
  • 공개된 카운터, 검색 순위, 분류, 댓글, 자막은 수집 이후에 바뀔 수 있습니다.
  • 요청한 결과 수 제한이 그만큼의 공개 레코드가 존재한다는 것을 보장하지는 않습니다.
  • SocQ는 공식 YouTube API가 아니며, YouTube 콘텐츠를 관리·생성·수정·삭제하거나 좋아요·댓글을 남기지 않습니다.

YouTube API 자주 묻는 질문

SocQ는 공식 YouTube API인가요?

아니요. SocQ는 지원되는 공개 결과를 수집하고 정규화합니다. 공식 OAuth, 채널 관리, 승인된 작업이 필요하면 YouTube Data API를 사용하세요.

사용자가 YouTube 계정을 연결해야 하나요?

아니요. 지원되는 공개 데이터 엔드포인트에는 고객의 YouTube OAuth가 필요하지 않으며, 요청은 SocQ API 키로 인증합니다.

어떤 YouTube 리소스를 사용할 수 있나요?

Channels, Videos, Channel Videos, Comments, Shorts, Search, Hashtag Search, Transcripts를 사용할 수 있으며, 각각 문서화된 입력과 정규화된 결과 사양이 있습니다.

사용량은 어떻게 과금되나요?

각 엔드포인트 카드에 현재 결과당 크레딧 가격이 표시되며, 플레이그라운드에서는 엔드포인트의 과금 규칙에 따라 제출한 요청의 예상 비용을 계산합니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.