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 사용 방법
키워드로 검색하고 일치하는 채널을 페이지 단위로 읽어 옵니다.
- {"query": "home cooking", "results_limit": 20}을 /v1/youtube/search-channels로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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에 넘겨 비즈니스 연락처를 공개했는지 확인하세요.
관련 API
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 Comments API
- YouTube Transcripts API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Trending Videos API