youtube/
search-channels

키워드로 YouTube 채널을 검색해 채널 ID, 이름, 구독자 수, 아바타, YouTube 검색에 표시되는 설명 일부를 검색 순서대로 받아 옵니다.

YouTube Channel Search API

키워드 입력
구독자 수
최대 200개 채널
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

YouTube Channel Search

채널 검색 결과는 YouTube가 키워드에 맞춰 보여 주는 크리에이터 계정으로, 채널마다 이름, 아바타, 구독자 수, 설명의 첫 몇 줄이 함께 표시됩니다. 이 결과를 훑어보면 어떤 채널이 그 주제를 다루는지 가늠하고, 대형 채널과 성장 중인 채널을 구분하고, 크리에이터 조사나 섭외를 위한 첫 목록을 가장 빠르게 만들 수 있습니다.

YouTube Channel Search API 주요 기능

  • 채널만 검색검색 대상이 채널로 한정되므로, home cooking 같은 키워드를 넣으면 동영상과 재생목록이 섞이지 않고 크리에이터 계정만 반환됩니다.
  • 채널별 구독자 수metrics.followers_count 값은 3.69M처럼 YouTube에 표시된 구독자 수를 변환한 합계입니다.
  • 변하지 않는 채널 ID와 링크모든 결과에 UC로 시작하는 채널 ID와 이를 바탕으로 만든 채널 URL이 담겨 있어, 채널 단위 API에 바로 넘길 수 있습니다.
  • 설명 일부text 필드에는 검색 결과에 표시되는 설명 발췌가 담기며, 여기에 채널의 분야나 비즈니스 연락처가 적혀 있는 경우가 많습니다.

YouTube Channel Search API 매개변수

매개변수필수설명
query필수채널을 찾을 키워드로, 최대 100자입니다.
results_limit선택반환할 채널 수로, 1~200 사이에서 지정합니다. 기본값은 20입니다.

YouTube Channel Search API 사용 방법

키워드로 검색하고 일치하는 채널을 페이지 단위로 읽어 옵니다.

  1. {"query": "home cooking", "results_limit": 20}을 /v1/youtube/search-channels로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 채널을 읽고, has_more가 true인 동안 results.next_cursor 값을 넘겨 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# Each item is one channel with name, text and metrics.followers_count.

YouTube Channel Search API 추천 활용 사례

  • 크리에이터 후보 목록 만들기: 담당 분야의 키워드로 검색하고, followers_count 값이 함께 일하는 규모에 맞는 채널만 남깁니다.
  • 주제를 장악한 채널 파악: 키워드 상위 결과의 구독자 수를 비교해 소수의 대형 채널이 그 주제를 장악하고 있는지 판단합니다.
  • 채널 조사의 출발점 마련: 반환된 채널 URL을 YouTube Channels와 YouTube Channel Videos에 넘겨 크리에이터별로 깊이 있게 분석합니다.

YouTube Channel Search API 활용 팁

  • 구독자 수는 반올림된 표시 텍스트에서 나온 값이므로, 정확한 수치가 필요하면 YouTube Channels를 사용하세요.
  • 같은 주제를 여러 표현으로 검색하고 채널 id 기준으로 결과를 합치면 목록을 넓힐 수 있습니다.
  • 가능성이 보이는 채널은 YouTube Email Finder에 넘겨 비즈니스 연락처를 공개했는지 확인하세요.

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

  • YouTube Channel Videos API — 채널 URL에서 쇼츠와 라이브 방송을 제외한 일반 공개 동영상을 수집합니다.
  • YouTube Channels API — 공개 채널 정보, 이미지, 인증 여부, 공개된 오디언스 통계를 가져옵니다.
  • YouTube Search API — 키워드로 공개 일반 동영상을 검색하며, 지원되는 메타데이터 필터를 사용할 수 있습니다.
  • YouTube Hashtag Search API — 해시태그 피드에서 공개 동영상을 찾으며, 전체 콘텐츠 또는 쇼츠만 선택해 수집할 수 있습니다.
  • YouTube Shorts Search API — 키워드로 쇼츠를 검색하며, 링크, 캡션, 조회수, 세로형 썸네일을 포함합니다.
  • YouTube Email Finder API — 채널 URL로 공개 비즈니스 이메일을 찾으며, 주소마다 해당 주소가 나타난 페이지를 함께 반환합니다.

다른 플랫폼 둘러보기

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

YouTube Channel Search API — 자주 묻는 질문

YouTube Channel Search API는 키워드와 일치하는 YouTube 채널을 찾는 프로그래밍 인터페이스입니다. 채널 ID, 이름, 구독자 수, 아바타, 설명 일부를 YouTube 검색 순서대로 반환합니다.

results_limit 값을 1~200 사이로 지정하며, 기본값은 20입니다. 이 값에 도달하거나 YouTube 검색 결과가 끝날 때까지 페이지를 자동으로 넘겨 가져옵니다.

검색 결과는 UC로 시작하는 채널 ID와 채널 URL로 채널을 식별합니다. 핸들과 전체 프로필이 필요하면 그 URL을 YouTube Channels에 보내세요.

필요하지 않습니다. 요청에는 SocQ API 키를 사용하고 반환된 채널 수에 따라 크레딧으로 과금되므로, Google Cloud 프로젝트나 일일 할당량을 관리할 필요가 없습니다.

반환된 채널 1개당 0.6 크레딧이 차감되므로, 기본값인 채널 20개는 12 크레딧입니다.