YouTubeYouTube Shorts커뮤니티 게시물크리에이터 아웃리치API 가이드

YouTube API 신규 엔드포인트: 인기 Shorts, 커뮤니티 게시물, 채널 검색, 이메일

SocQ YouTube 신규 엔드포인트 8개로 인기 Shorts, Shorts·채널 검색, 검색어 추천, 커뮤니티 게시물과 댓글, 관련 동영상, 채널 비즈니스 이메일을 가져옵니다.

SocQ2026년 11월 19일 업데이트약 7분 소요

SocQ는 이미 공개 YouTube 채널, 동영상, Shorts, 댓글, 검색, 재생목록, 스크립트를 반환해 왔습니다. YouTube 스크래퍼 API 추천 7선에서 이들을 비교하고, YouTube 스크립트 가이드에서는 자막 텍스트를 대량으로 가져오는 방법을 다룹니다. 2026-11-17에는 엔드포인트 8개가 YouTube 플랫폼 페이지에 추가로 공개되었습니다. Shorts 리서치, 크리에이터 발굴과 아웃리치, 그리고 크리에이터가 업로드 사이사이에 올리는 커뮤니티 게시물에서 비어 있던 부분을 채웁니다.

이 가이드에서는 새 엔드포인트를 용도별로 묶고, 각각의 요청 예시와 가격, 그리고 언제 쓰면 좋은지를 소개합니다.

빠른 답변: POST https://api.socq.ai/v1/youtube/<endpoint>에 JSON 본문을 보내세요. 반환된 task_id를 저장하고 status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 data.results.items를 읽습니다.

신규 YouTube 엔드포인트 한눈에 보기

1 SocQ 크레딧 = $0.005입니다. 결과 단위로 과금되는 엔드포인트는 기본 요금이 없으므로 결과가 비어 있으면 비용이 발생하지 않습니다.

엔드포인트반환 내용가격
YouTube Trending Shorts API지금 인기 있는 Shorts의 새 샘플과 채널, 조회수, 좋아요, 댓글, 길이, 게시 시각Short 1개당 0.5 크레딧($0.0025)
YouTube Shorts Search API키워드에 맞는 Shorts와 링크, 캡션, 조회수, 세로형 썸네일Short 1개당 0.6 크레딧($0.003)
YouTube Channel Search API키워드에 맞는 채널과 ID, 이름, 구독자 수, 아바타, 설명 일부채널 1개당 0.6 크레딧($0.003)
YouTube Search Suggestions API입력 중인 검색어에 대한 순위별 자동완성 추천어(언어·지역별)호출 1회당 0.5 크레딧($0.0025)
YouTube Community Post API커뮤니티 게시물 1개의 전체 텍스트, 모든 이미지, 좋아요, 채널호출 1회당 0.5 크레딧($0.0025)
YouTube Community Post Comments API커뮤니티 게시물의 댓글과 작성자, 좋아요, 답글 수댓글 1개당 0.3 크레딧($0.0015)
YouTube Related Videos APIYouTube가 동영상 옆에 추천하는 동영상동영상 1개당 0.5 크레딧($0.0025)
YouTube Email Finder API채널의 공개 비즈니스 이메일과 발견된 페이지이메일이 있는 채널 1개당 15 크레딧($0.075), 찾지 못하면 무료

인증과 비동기 작업 흐름

모든 요청은 API 키로 인증합니다. 제출, 작업 상태 조회, 결과 조회 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 호출은 즉시 data.task_id와 data.status를 반환합니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded가 되면 응답에 result_count, credits_amount, 그리고 data.results.items에 담긴 정규화 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500입니다. results.has_more가 true이면 results.next_cursor를 cursor로 전달해 다음 페이지를 읽으세요. 실패한 작업에는 error_message가 담깁니다.

아래의 모든 엔드포인트는 선택 사항인 callback_url도 받습니다. 작업이 끝나면 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 작업 엔드포인트에서 읽습니다. 클라이언트 측 타임아웃이 작업을 취소하지는 않으므로 다시 제출하지 말고 같은 작업 ID로 조회를 이어가세요. 402는 계정의 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

Shorts와 검색 수요 조사하기

Trending Shorts는 YouTube가 지금 인기 콘텐츠로 노출하고 있는 Shorts를 샘플링하며, 각 Short의 제목, 채널, 조회수, 좋아요, 댓글, 길이, 게시 시각을 반환합니다. 모든 필드는 선택 사항이고, results_limit은 기본값 48이며 최대 200입니다. 실행할 때마다 새로 샘플링하므로 몇 분 간격으로 두 번 실행해도 겹치는 Shorts는 몇 개뿐입니다. 따라서 큰 호출 한 번보다 예약 작업을 여러 번 돌리는 편이 하루 동안 더 넓은 그림을 보여 줍니다. (문서)

curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit": 48}'

Shorts Search는 키워드에 맞는 Shorts를 YouTube 검색 순서대로 반환하며 링크, 캡션, 조회수, 세로형 썸네일을 담습니다. 검색 결과에는 이 기본 정보만 들어 있으므로, 좋아요, 댓글, 채널 정보도 필요하다면 남길 링크를 YouTube Videos에 전달하세요. results_limit은 기본값 25입니다(1~200). (문서)

curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "meal prep", "results_limit": 25}'

Search Suggestions는 검색어 앞부분에 대해 YouTube 검색창이 제안하는 자동완성어를 시청자에게 보이는 순위 그대로 반환합니다. language의 기본값은 en, region의 기본값은 US이며, 값을 바꾸면 같은 시드 키워드가 다른 시장에서 어떻게 뻗어 나가는지 볼 수 있습니다. 추천어 개수와 관계없이 호출 1회당 한 번 과금됩니다. 키워드 리서치, 제목, 태그 작성에 활용하세요. (문서)

curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "iphone 17"}'

크리에이터 발굴과 연락처 이메일 찾기

Channel Search는 키워드에 맞는 채널을 YouTube 순서대로 찾아 채널 ID, 이름, 구독자 수, 아바타, 검색 결과에 표시되는 설명 일부를 반환합니다. results_limit은 기본값 20입니다(1~200). 크리에이터 발굴의 첫 단계로, 여기서 후보를 추린 다음 YouTube Channels로 상세 정보를, YouTube Channel Videos로 업로드 목록을 가져오세요. (문서)

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}'

Email Finder는 크리에이터가 채널 설명, 연결된 소셜 프로필, 링크 인 바이오 페이지, 자체 사이트 등에 공개한 비즈니스 이메일을 찾습니다. emails의 각 주소에는 해당 주소가 발견된 source_urls가 함께 담깁니다. url에는 @handle 또는 /channel/UC... 형식의 채널 링크를 넣습니다. 공개 이메일이 하나 이상 있는 채널은 찾은 주소를 모두 담은 결과 1건을 반환하며 15 크레딧($0.075)이 부과되고, 이메일이 없는 채널은 빈 결과를 반환하며 과금되지 않습니다. (문서)

curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@mkbhd"}'

비용 예시: 채널 20개를 검색하고(12 크레딧) 20개 모두에 Email Finder를 실행합니다. 그중 8개에 이메일이 있다면 120 크레딧이 들어 총 132 크레딧($0.66)입니다. 공개 이메일이 없는 나머지 12개 채널에는 비용이 들지 않습니다.

커뮤니티 게시물과 댓글 읽기

Community Post는 링크로 게시물 하나를 읽어 전체 텍스트, 첨부된 모든 이미지, 좋아요 수, 게시한 채널을 반환합니다. url에는 https://www.youtube.com/post/{post_id} 링크나 ?lb={post_id}가 붙은 채널 게시물 탭 링크를 넣습니다. YouTube Community Posts 결과처럼 이미 게시물 URL을 갖고 있을 때 사용하세요. (문서)

curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

Community Post Comments는 투표, 공지, 이미지 게시물 같은 게시물 아래의 댓글을 수집하며 각 댓글 작성자의 채널, metrics.likes_count, metrics.replies_count를 담습니다. 게시물 댓글은 동영상 댓글과 별도로 존재하므로, 크리에이터가 업로드 사이에 올린 소식에 대한 반응은 이 엔드포인트로 읽어야 합니다. 같은 URL 형식을 사용할 수 있으며, results_limit은 기본값 100입니다(1~1000). (문서)

curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'

YouTube가 다음에 추천하는 동영상 보기

Related Videos는 YouTube가 동영상 옆에 다음 볼 동영상으로 배치하는 목록을 제목, 채널, 조회수, 썸네일과 함께 반환합니다. url에는 watch, youtu.be, Shorts, 라이브 링크를 넣을 수 있습니다. 한 번 실행하면 보통 20개 안팎인 추천 목록 전체가 반환되고 동영상 단위로 과금되므로, 일반적인 호출은 10 크레딧($0.05) 정도입니다. 자신의 업로드나 경쟁사 동영상에 실행해 YouTube가 어떤 동영상과 채널을 이웃으로 보는지 확인하세요. (문서)

curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

관련 YouTube 가이드

SocQ를 다른 YouTube 데이터 제공업체와 비교하려면 2026년 추천 YouTube API 대안 19선을 참고하세요. 팔로워 국가와 가짜 조회수 확인을 포함해 TikTok에서 같은 발굴·아웃리치 흐름을 구성하는 방법은 TikTok 신규 엔드포인트 가이드에 있습니다.

자주 묻는 질문(FAQ)

공개 이메일이 없는 채널도 과금되나요?

아니요. 공개 이메일이 없는 채널은 빈 결과를 반환하며 무료입니다. 이메일이 하나 이상 있는 채널은 주소가 몇 개든 15 크레딧이 부과됩니다.

실행할 때마다 그 순간 인기 있는 콘텐츠를 샘플링하므로, 몇 분 간격으로 실행해도 겹치는 Shorts는 몇 개뿐입니다. 더 넓게 수집하려면 여러 번 실행하도록 예약하세요.

어떤 커뮤니티 게시물 URL을 사용할 수 있나요?

https://www.youtube.com/post/{post_id} 또는 ?lb={post_id}가 붙은 채널 게시물 탭 링크입니다.

Shorts Search가 좋아요와 댓글도 반환하나요?

아니요. 검색 결과에는 링크, 캡션, 조회수, 썸네일만 담깁니다. 좋아요, 댓글, 채널 정보는 링크를 YouTube Videos에 전달해 가져오세요.

Search Suggestions는 어떻게 과금되나요?

반환되는 추천어 개수와 관계없이 호출 1회당 0.5 크레딧입니다.

YOUTUBE API

공개 YouTube URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

YouTube API 살펴보기