플랫폼 가용성
- 24시간 상태
- 100%
최근 30일
제공 기능
각 YouTube 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 YouTube 동영상을 호출당 최대 50개까지 검색합니다. | 요청 1,000개당 $0.56 | 양호 · 상태 100% |
채널 상세 정보profile | 채널 URL로 YouTube 채널 정보를 가져옵니다. | 요청 1,000개당 $0.56 | 정상 |
사용자 게시물user_posts | YouTube 채널 URL로 동영상을 호출당 최대 50개까지 나열합니다. | 요청 1,000개당 $0.56 | 정상 |
동영상 상세 정보video | 시청 링크나 공유 링크로 YouTube 동영상 하나의 제목, 설명, 채널, 조회수, 좋아요, 댓글 수, 재생 시간, 게시일을 가져옵니다. | 요청 1,000개당 $0.56 | 정상 |
댓글comments | YouTube 동영상의 댓글을 호출당 최대 100개까지 읽습니다. | 요청 1,000개당 $0.56 | 정상 |
팔로워followers | 핸들로 YouTube 채널의 구독자 수를 확인합니다. | 요청 1,000개당 $0.56 | 정상 |
트랜스크립트transcript | YouTube 동영상의 자막을 전체 텍스트와 타임스탬프가 있는 구간으로 가져오며, 트랙 언어, 사용 가능한 언어, 채널 정보가 포함됩니다. | 요청 1,000개당 $0.56 | 정상 |
Shortsshorts | 핸들로 YouTube 채널의 Shorts를 호출당 최대 100개까지 둘러봅니다. | 요청 1,000개당 $0.56 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
YouTube 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 YouTube 동영상을 호출당 최대 50개까지 검색합니다. 채널, 설명, 조회수, 좋아요, 댓글, 재생 시간, 게시일을 가져옵니다. | keyword | sort | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
profile채널 상세 정보 채널 URL로 YouTube 채널 정보를 가져옵니다. 소개, 구독자·동영상·조회수, 인증 여부, 위치, 아바타, 배너, 생성일이 포함됩니다. YouTube Analytics나 구독자 목록은 제공하지 않습니다. | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | channel_id · name · url · bio · subscriber_count · video_count · view_count · is_verified · location · avatar_url · banner_url · created_at · platform |
user_posts사용자 게시물 YouTube 채널 URL로 동영상을 호출당 최대 50개까지 나열합니다. 제목, 설명, 조회수, 좋아요, 댓글, 재생 시간, 게시일을 가져옵니다. 시작 날짜는 | url | since, sort | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
video동영상 상세 정보 시청 링크나 공유 링크로 YouTube 동영상 하나의 제목, 설명, 채널, 조회수, 좋아요, 댓글 수, 재생 시간, 게시일을 가져옵니다. 댓글과 스크립트는 각각 별도 액션인 | url | — | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
comments댓글 YouTube 동영상의 댓글을 호출당 최대 100개까지 읽습니다. 각 댓글에는 텍스트, 작성자, 좋아요, 답글 수, 날짜, 답글 여부가 포함됩니다. 최신순 또는 인기순으로 정렬하고, | url | since, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · text · author_name · like_count · reply_count · posted_at · is_reply · reply_to_id · platform |
followers팔로워 핸들로 YouTube 채널의 구독자 수를 확인합니다. 팔로잉·게시물·좋아요·연결 수와, 반올림된 수치인지 나타내는 정밀도 플래그를 가져옵니다. | username | channel | Sync 응답 | — | 요청 1,000개당 $0.56 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcript트랜스크립트 YouTube 동영상의 자막을 전체 텍스트와 타임스탬프가 있는 구간으로 가져오며, 트랙 언어, 사용 가능한 언어, 채널 정보가 포함됩니다. | url | language | Sync 응답 | — | 요청 1,000개당 $0.56 | id · url · title · text · segments · language · available_languages · channel_id · channel_name · channel_username · view_count · like_count · comment_count · posted_at · platform |
shortsShorts 핸들로 YouTube 채널의 Shorts를 호출당 최대 100개까지 둘러봅니다. 제목, 썸네일, 조회수, 좋아요, 재생 시간, 게시일을 가져옵니다. | username | channel, since, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $0.56 | id · url · title · thumbnail_url · view_count · like_count · duration · posted_at · author_name · author_id · author_url · platform |
YouTube search 파라미터는 각각 무엇을 의미하나요?
키워드로 YouTube 동영상을 호출당 최대 50개까지 검색합니다. 채널, 설명, 조회수, 좋아요, 댓글, 재생 시간, 게시일을 가져옵니다. sort로 관련도순, 최신순, 조회수순, 평점순으로 정렬합니다. 결과가 전부 포함되지는 않으며, 순위 기준은 공개되지 않습니다.
keyword필수- YouTube search 액션의 검색어입니다. shorts 액션의 호환용 입력으로 전달하면 사이트 전체 Shorts 검색이 아니라 채널 이름으로 처리됩니다.
sort선택- YouTube 액션 전반에 적용되는 정렬 순서입니다. search는 relevance, newest, most_viewed, top_rated를 받습니다. 채널 동영상과 Shorts는 newest, oldest, popular를 받습니다. comments는 newest, popular를 받습니다. 단일 동영상 조회에 이 파라미터를 지정해도 해당 동영상의 콘텐츠는 필터링되지 않습니다.허용 값:
most_viewednewestrelevancetop_rated
YouTube profile 파라미터는 각각 무엇을 의미하나요?
채널 URL로 YouTube 채널 정보를 가져옵니다. 소개, 구독자·동영상·조회수, 인증 여부, 위치, 아바타, 배너, 생성일이 포함됩니다. YouTube Analytics나 구독자 목록은 제공하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- YouTube 액션에 필요한 대상 URL입니다. profile과 user_posts에는 전체 채널 URL을, video, comments, transcript에는 특정 watch?v= 링크나 공유 링크를 사용하세요. 채널 메타데이터는 게시된 콘텐츠에서 도출되며, comments는 채널 커뮤니티 게시판의 게시물을 반환하지 않습니다.
YouTube user_posts 파라미터는 각각 무엇을 의미하나요?
YouTube 채널 URL로 동영상을 호출당 최대 50개까지 나열합니다. 제목, 설명, 조회수, 좋아요, 댓글, 재생 시간, 게시일을 가져옵니다. 시작 날짜는 since로, 최신순·오래된순·인기순 정렬은 sort로 지정합니다. 한 번의 호출로 채널의 전체 동영상을 가져오지 못할 수 있습니다.
url필수- YouTube 액션에 필요한 대상 URL입니다. profile과 user_posts에는 전체 채널 URL을, video, comments, transcript에는 특정 watch?v= 링크나 공유 링크를 사용하세요. 채널 메타데이터는 게시된 콘텐츠에서 도출되며, comments는 채널 커뮤니티 게시판의 게시물을 반환하지 않습니다.
since선택- 채널 동영상, Shorts, 댓글을 필터링할 날짜 하한입니다. 이 목록에만 적용됩니다.
sort선택- YouTube 액션 전반에 적용되는 정렬 순서입니다. search는 relevance, newest, most_viewed, top_rated를 받습니다. 채널 동영상과 Shorts는 newest, oldest, popular를 받습니다. comments는 newest, popular를 받습니다. 단일 동영상 조회에 이 파라미터를 지정해도 해당 동영상의 콘텐츠는 필터링되지 않습니다.허용 값:
newestoldestpopular
YouTube video 파라미터는 각각 무엇을 의미하나요?
시청 링크나 공유 링크로 YouTube 동영상 하나의 제목, 설명, 채널, 조회수, 좋아요, 댓글 수, 재생 시간, 게시일을 가져옵니다. 댓글과 스크립트는 각각 별도 액션인 comments와 transcript로 가져옵니다.
url필수- YouTube 액션에 필요한 대상 URL입니다. profile과 user_posts에는 전체 채널 URL을, video, comments, transcript에는 특정 watch?v= 링크나 공유 링크를 사용하세요. 채널 메타데이터는 게시된 콘텐츠에서 도출되며, comments는 채널 커뮤니티 게시판의 게시물을 반환하지 않습니다.
YouTube comments 파라미터는 각각 무엇을 의미하나요?
YouTube 동영상의 댓글을 호출당 최대 100개까지 읽습니다. 각 댓글에는 텍스트, 작성자, 좋아요, 답글 수, 날짜, 답글 여부가 포함됩니다. 최신순 또는 인기순으로 정렬하고, since로 시작 날짜를 설정합니다. 답글을 연결하려면 reply_to_id를 사용합니다. 전체 스레드를 보장하지 않습니다.
url필수- YouTube 액션에 필요한 대상 URL입니다. profile과 user_posts에는 전체 채널 URL을, video, comments, transcript에는 특정 watch?v= 링크나 공유 링크를 사용하세요. 채널 메타데이터는 게시된 콘텐츠에서 도출되며, comments는 채널 커뮤니티 게시판의 게시물을 반환하지 않습니다.
since선택- 채널 동영상, Shorts, 댓글을 필터링할 날짜 하한입니다. 이 목록에만 적용됩니다.
sort선택- YouTube 액션 전반에 적용되는 정렬 순서입니다. search는 relevance, newest, most_viewed, top_rated를 받습니다. 채널 동영상과 Shorts는 newest, oldest, popular를 받습니다. comments는 newest, popular를 받습니다. 단일 동영상 조회에 이 파라미터를 지정해도 해당 동영상의 콘텐츠는 필터링되지 않습니다.허용 값:
newestpopular
YouTube followers 파라미터는 각각 무엇을 의미하나요?
핸들로 YouTube 채널의 구독자 수를 확인합니다. 팔로잉·게시물·좋아요·연결 수와, 반올림된 수치인지 나타내는 정밀도 플래그를 가져옵니다. username에 @핸들을 전달합니다. 구독자 목록이 아닌 집계 수치를 반환합니다.
username필수- followers 및 shorts 액션에 필요한 채널 핸들입니다(앞의 @는 선택). followers 액션은 사용자 목록이 아닌 전체 구독자 수를 반환합니다. shorts 액션은 핸들을 우선하며, UC... 채널 ID를 동일한 식별자로 취급하지 않습니다.
channel선택- 채널 핸들을 지정하는 호환용 별칭입니다. 전체 /channel/UC... URL은 보조 유틸리티에서 파싱에 실패할 수 있으므로, 핸들을 전달하거나 액션에서 명시적으로 제공하는 URL 파라미터를 사용하세요.
YouTube transcript 파라미터는 각각 무엇을 의미하나요?
YouTube 동영상의 자막을 전체 텍스트와 타임스탬프가 있는 구간으로 가져오며, 트랙 언어, 사용 가능한 언어, 채널 정보가 포함됩니다. language로 특정 트랙을 요청할 수 있지만, 모든 동영상에 자막이 있는 것은 아니며 자동 번역도 보장되지 않습니다.
url필수- YouTube 액션에 필요한 대상 URL입니다. profile과 user_posts에는 전체 채널 URL을, video, comments, transcript에는 특정 watch?v= 링크나 공유 링크를 사용하세요. 채널 메타데이터는 게시된 콘텐츠에서 도출되며, comments는 채널 커뮤니티 게시판의 게시물을 반환하지 않습니다.
language선택- 자막 콘텐츠에 요청할 언어 코드입니다. 자막은 제공되는 트랙에 따라 반환되며, 자동 번역은 보장되지 않습니다.
YouTube shorts 파라미터는 각각 무엇을 의미하나요?
핸들로 YouTube 채널의 Shorts를 호출당 최대 100개까지 둘러봅니다. 제목, 썸네일, 조회수, 좋아요, 재생 시간, 게시일을 가져옵니다. username에는 UC 채널 ID가 아닌 핸들을 전달합니다. 한 번의 호출로 채널의 모든 Shorts를 가져오지 못할 수 있습니다.
username필수- followers 및 shorts 액션에 필요한 채널 핸들입니다(앞의 @는 선택). followers 액션은 사용자 목록이 아닌 전체 구독자 수를 반환합니다. shorts 액션은 핸들을 우선하며, UC... 채널 ID를 동일한 식별자로 취급하지 않습니다.
channel선택- 채널 핸들을 지정하는 호환용 별칭입니다. 전체 /channel/UC... URL은 보조 유틸리티에서 파싱에 실패할 수 있으므로, 핸들을 전달하거나 액션에서 명시적으로 제공하는 URL 파라미터를 사용하세요.
since선택- 채널 동영상, Shorts, 댓글을 필터링할 날짜 하한입니다. 이 목록에만 적용됩니다.
sort선택- YouTube 액션 전반에 적용되는 정렬 순서입니다. search는 relevance, newest, most_viewed, top_rated를 받습니다. 채널 동영상과 Shorts는 newest, oldest, popular를 받습니다. comments는 newest, popular를 받습니다. 단일 동영상 조회에 이 파라미터를 지정해도 해당 동영상의 콘텐츠는 필터링되지 않습니다.허용 값:
newestoldestpopular
YouTube API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"youtube","action":"search","params":{"keyword":"<keyword>"}}'
YouTube 가이드
이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.
YouTube 댓글 수집에서 답글이 누락되는 이유: 2단계 페이지네이션과 완전성 검증
YouTube commentThreads에 항상 모든 답글이 포함되는 것은 아닙니다. 이 가이드는 공식 문서를 바탕으로 comments.list, parentId, 2단계 페이지네이션, 중복 제거, 댓글 수 불일치를 설명하고, 재현 가능한 수집 결과 검수 방법을 제시합니다.
글 읽기캠페인 전 실사를 위한 크리에이터 데이터 구성법: 팔로워 수를 오디언스의 증거로 삼지 않기
크리에이터 데이터 제품은 블랙박스식 진정성 점수를 만들어 내지 않아야 합니다. 이 글에서는 공개 지표, 승인된 분석 데이터, 콘텐츠와 브랜드의 적합성, 광고 표기 요건, 소규모 테스트, 캠페인 후 피드백이 어떻게 검증 가능한 실사를 구성하는지 살펴봅니다.
글 읽기통합 데이터 API 시작하기: 기능 카탈로그에서 사용 가능한 첫 결과까지
platform, action, params로 여러 플랫폼의 데이터에 접근합니다. 기능 카탈로그를 읽고, 최소한의 요청을 완료하고, 비동기 작업과 부분 결과, 과금을 처리하며, 추적 가능한 데이터 기록을 만듭니다.
글 읽기YouTube API 자주 묻는 질문
YouTube API로 무엇을 가져올 수 있나요?
platform을 youtube 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 채널 상세 정보, 사용자 게시물, 동영상 상세 정보, 댓글 및 more입니다. 각 액션 이름은 서로 다른 YouTube 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
YouTube search 요청에는 어떤 입력이 필요한가요?
YouTube search 액션의 검색어입니다. shorts 액션의 호환용 입력으로 전달하면 사이트 전체 Shorts 검색이 아니라 채널 이름으로 처리됩니다. params 안의 keyword 필드로 전달하세요.
YouTube search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, author_name 및 author_username입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 YouTube 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.