youtube/
channels

채널 URL로 공개 YouTube 채널 프로필을 가져와 정규화된 식별 정보, 설명, 이미지, 인증 여부, 공개된 오디언스 통계를 반환합니다.

YouTube Channels API

채널
공개 프로필
공개 지표
결과당 0.26 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

YouTube Channels

YouTube 채널은 크리에이터·브랜드·조직의 공개 페이지로, 식별 정보, 설명, 이미지, 인증 여부, 프로필 링크, 공개된 구독자·동영상·조회수 합계를 담고 있습니다. 이러한 채널 신호는 크리에이터 조사, 오디언스 비교, 디렉터리 보강, 시장 분석에 활용할 수 있습니다.

YouTube Channels API 주요 기능

  • 여러 채널 프로필 수집한 번의 요청으로 여러 채널 URL의 공개 프로필을 수집합니다.
  • 정규화된 채널 식별 정보채널 ID, 핸들, 표시 이름, 정식 URL, 설명, 아바타, 배너를 일관된 구조로 반환합니다.
  • 공개 채널 지표인증 상태, 공개된 구독자 수, 게시된 동영상 수, 채널 전체 조회수를 포함합니다.
  • 프로필 부가 정보 필드공개된 위치, 프로필 링크, 채널 생성일, 제출한 채널 URL을 그대로 보존합니다.
  • 수집 타임스탬프모든 결과에 collected_at 필드를 추가하므로, 저장한 레코드를 수집 날짜별로 비교할 수 있습니다.

YouTube Channels API 매개변수

매개변수필수설명
urls필수공개 YouTube 채널 URL로, 쉼표 또는 줄바꿈으로 구분합니다.

YouTube Channels API 사용 방법

공개 채널 페이지 목록을 안정적인 식별 정보 레코드로 바꿔 줍니다. 요청은 비동기로 처리되므로, 제출한 모든 채널의 조회가 끝날 때까지 작업 ID를 보관하세요.

  1. 동영상 시청 URL이 아닌, 중복을 제거한 공개 채널 URL 또는 @handle URL 목록을 준비합니다.
  2. urls 배열을 /v1/youtube/channels로 POST하고, 반환된 task_id를 저장합니다.
  3. /v1/tasks/{task_id}를 폴링합니다. queued와 running은 정상적인 중간 상태입니다.
  4. 작업이 성공하면 data.results.items를 id 기준으로 인덱싱하고, has_more가 true이면 next_cursor로 이어서 가져옵니다.
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 Channels API 추천 활용 사례

  • 크리에이터·브랜드 디렉터리: 고유한 채널 ID, 프로필 정보, 이미지, 링크, 공개 오디언스 지표로 디렉터리를 보강합니다.
  • 크리에이터 검토: 제휴 후보를 평가할 때 채널 설명, 인증 여부, 공개된 오디언스 규모, 게시 활동, 프로필 링크를 살펴봅니다.
  • 채널 비교: 크리에이터, 브랜드, 매체, 경쟁사의 공개 구독자 수·동영상 수·조회수를 비교합니다.
  • 프로필 모니터링: 같은 채널을 주기적으로 수집해 공개 프로필 정보와 오디언스 통계의 변화를 추적합니다.

YouTube Channels API 활용 팁

  • id를 기본 키로 저장하세요. 핸들은 표시와 라우팅에는 유용하지만, 새 채널이 만들어지지 않아도 바뀔 수 있습니다.
  • 숨겨진 구독자 수를 0으로 바꾸지 마세요. null은 공개된 값이 없다는 뜻이며, 비즈니스 관점에서는 전혀 다른 신호입니다.
  • 설명에 포함된 링크는 신뢰할 수 없는 외부 URL로 취급하세요. 내부 도구에 표시하기 전에 검증하고 정제해야 합니다.
  • 오디언스 카운터는 collected_at이 있는 경우에만 비교하고, 추세를 계산할 때는 수집 주기를 일정하게 유지하세요.
  • 채널이 삭제되었거나 제한되었거나 더 이상 공개되지 않으면, 성공한 배치라도 URL 수보다 레코드가 적을 수 있습니다.
  • 모든 콘텐츠 행에 프로필 필드를 반복해서 넣지 말고, 채널 ID를 기준으로 Channels를 Channel Videos 또는 Shorts와 조인하세요.

YouTube Channels API 외에 YouTube의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
  • YouTube Comments API — 공개 댓글, 작성자, 참여도, 원본 동영상, 대화 맥락을 수집합니다.
  • YouTube Transcripts API — 제공되는 일반 텍스트 스크립트를 가져오며, 언어를 선택할 수 있습니다.
  • YouTube Shorts API — 채널별로 공개 쇼츠, 썸네일, 길이, 게시 정보, 참여도를 수집합니다.
  • YouTube Community Posts API — 채널 URL에서 공개 커뮤니티 탭 게시물을 수집하며, 텍스트, 채널 정보, 타임스탬프, 이미지 참조, 출처 맥락을 포함합니다.
  • YouTube Email Finder API — 채널 URL로 공개 비즈니스 이메일을 찾으며, 주소마다 해당 주소가 나타난 페이지를 함께 반환합니다.

다른 플랫폼 둘러보기

YouTube 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

YouTube Channels API — 자주 묻는 질문

YouTube Channels API는 하나 이상의 YouTube 채널 URL에서 공개된 프로필 데이터를 가져옵니다. 정규화된 식별 정보, 설명, 이미지, 인증 여부, 오디언스 통계, 위치, 프로필 링크, 수집 시각을 반환합니다.

urls 배열에 공개 YouTube 채널 URL을 하나 이상 제출합니다. 접근할 수 있는 채널마다 정규화된 결과가 하나씩 반환됩니다.

네. 같은 urls 배열에 공개 채널 URL을 여러 개 넣으면 프로필 레코드를 한꺼번에 수집합니다.

채널이 구독자 수를 숨길 수 있고, 선택 항목인 공개 프로필 필드는 모든 채널에 있는 것이 아닙니다. 공개되지 않은 값은 0으로 표시되지 않고 비어 있는 상태로 유지됩니다.

아니요. 이 엔드포인트는 채널 프로필 데이터와 집계 통계를 반환합니다. 일반 업로드 동영상은 Channel Videos를, 채널의 쇼츠는 Shorts를 사용하세요.

반환된 정규화 채널 결과 1건당 0.26 크레딧이 차감됩니다.