YouTube Public Data API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.
사용 가능한 YouTube API
채널·동영상 직접 조회, 채널 기반 동영상·쇼츠 수집, 공개 댓글, 키워드·해시태그 탐색, 제공되는 스크립트 텍스트 중에서 선택하세요.

youtube/channels
프로필결과당 0.26 크레딧

youtube/videos
게시물결과당 0.5 크레딧

youtube/channel-videos
게시물결과당 0.5 크레딧

youtube/playlist-videos
게시물결과당 0.5 크레딧

youtube/channel-live-videos
게시물결과당 0.5 크레딧

youtube/comments
댓글결과당 0.3 크레딧

youtube/comment-replies
댓글결과당 0.5 크레딧

youtube/community-posts
게시물결과당 0.5 크레딧

youtube/shorts
게시물결과당 0.5 크레딧

youtube/search
검색결과당 0.5 크레딧

youtube/hashtag-search
검색결과당 0.5 크레딧

youtube/transcripts
게시물결과당 0.5 크레딧

youtube/trending-shorts
게시물결과당 0.5 크레딧

youtube/community-post
게시물요청당 0.5 크레딧

youtube/community-post-comments
댓글결과당 0.3 크레딧

youtube/related-videos
게시물결과당 0.5 크레딧

youtube/search-channels
검색결과당 0.6 크레딧

youtube/search-shorts
검색결과당 0.6 크레딧

youtube/search-suggestions
검색요청당 0.5 크레딧

youtube/channel-email
프로필결과당 15 크레딧

youtube/trending-videos
게시물결과당 0.5 크레딧
어떤 YouTube 데이터를 가져올 수 있나요?
SocQ는 지원되는 공개 YouTube 결과를 정규화된 레코드로 변환해 정보 보강, 모니터링, 리서치, 콘텐츠 분석, 리포트에 활용할 수 있게 합니다.
채널 프로필
채널 식별 정보, 소개, 공개 이미지, 인증 여부, 공개된 구독자 수·동영상 수·총 조회수를 가져옵니다.
동영상·쇼츠 메타데이터
제목, 설명, 채널 정보, 썸네일, 길이, 게시 관련 데이터, 공개된 참여 지표를 수집합니다.
공개 댓글 반응
공개된 댓글 텍스트, 작성자 정보, 좋아요 수, 답글 수, 동영상 참조, 부모 댓글과의 관계를 수집합니다.
탐색과 스크립트
키워드로 공개 일반 동영상을 검색하고, 해시태그 피드에 연결된 동영상을 수집하며, 알고 있는 URL의 자막을 일반 텍스트로 가져옵니다.
SocQ vs YouTube Data API
SocQ는 지원되는 공개 데이터 수집과 정규화된 결과에 초점을 맞춥니다. 공식 OAuth, 채널 관리, 승인된 작업이 필요하다면 YouTube Data API가 적합합니다.
| 기능 | SocQ | YouTube Data API |
|---|---|---|
| 주요 용도 | 지원되는 공개 데이터 수집 및 정규화 | 공식 플랫폼 연동 및 승인된 리소스 |
| 인증 | SocQ API 키 | 작업에 따라 Google OAuth 또는 API 자격 증명 |
| 콘텐츠 관리 | YouTube 콘텐츠를 생성·수정·삭제하거나 좋아요·댓글을 남기는 등의 관리를 하지 않음 | 승인된 범위 내의 작업 지원 |
| 비공개 또는 제한된 데이터 | 지원하지 않음 | 부여된 권한과 플랫폼 정책이 허용하는 데이터로 제한 |
| 응답 형식 | 정규화된 SocQ 레코드 | YouTube API 고유 리소스 |
YouTube API 작동 방식
8개 엔드포인트 모두 비동기 제출, 폴링, 커서 페이지네이션의 같은 흐름으로 동작합니다.
1. 공개 입력 제출
지원되는 채널 URL, 동영상 URL, 키워드 검색어, 해시태그와 엔드포인트별 선택 필터를 POST합니다.
2. 작업 폴링
반환된 작업 ID로 처리가 성공하거나 실패할 때까지 조회하고, 일시적인 부하 응답을 받으면 백오프를 적용합니다.
3. 읽기와 페이지네이션
data.results.items에서 정규화된 레코드를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.
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=50YouTube 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를 사용할 수 있으며, 각각 문서화된 입력과 정규화된 결과 사양이 있습니다.
사용량은 어떻게 과금되나요?
각 엔드포인트 카드에 현재 결과당 크레딧 가격이 표시되며, 플레이그라운드에서는 엔드포인트의 과금 규칙에 따라 제출한 요청의 예상 비용을 계산합니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Facebook API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.
Threads API
공개 Threads 프로필을 가져오고, 알고 있는 게시물을 확인하거나, 선택한 프로필의 게시물을 수집합니다. 식별 정보, 콘텐츠, 미디어, 참여도, 타임스탬프 필드가 정규화되어 제공됩니다.