2026년 11월 17일 화요일

에이픽으로 길이와 게시 시기로 교육 영상 후보를 찾는 큐레이션 만들기

에이픽은 검색·조회·변환 기능을 업무 시스템에 연결하는 API 플랫폼입니다. 유튜브 검색 API에 키워드와 결과 종류·업로드 시기·길이·정렬 조건을 보내면 영상·쇼츠·채널·재생목록의 검색 결과를 받을 수 있습니다. 교육 담당자는 정상 검색 건당 20P로 학습 시간과 주제에 맞는 후보를 확보하고, 실제 내용을 검토해 학습 순서가 분명한 큐레이션을 준비할 수 있습니다.

에이픽 공식 화면(2026-11-16 확인)
에이픽 공식 화면(2026-11-16 확인)

에이픽으로 무엇을 할 수 있나요

에이픽은 검색·조회·변환 기능을 업무 시스템에 연결하는 API 플랫폼입니다. 유튜브 검색 API에 키워드와 결과 종류·업로드 시기·길이·정렬 조건을 보내면 영상·쇼츠·채널·재생목록의 검색 결과를 받을 수 있습니다. 교육 담당자는 정상 검색 건당 20P로 학습 시간과 주제에 맞는 후보를 확보하고, 실제 내용을 검토해 학습 순서가 분명한 큐레이션을 준비할 수 있습니다.

실제 입력과 반환 결과

필수 검색어는 1~200자이며 결과 수는 기본 10·최대 50입니다. 결과 종류는 any·video·channel·playlist·movie, 정렬은 관련도·업로드일·조회수·평점 조건을 사용합니다. 길이는 4분 미만·4~20분·20분 초과의 구간으로 선택하고 업로드 시기도 지정할 수 있습니다. 결과 항목의 type에 따라 제공 필드가 다르며 영상·쇼츠는 길이·조회수·채널 등을 읽습니다. 추가 조사는 검색어와 조건별로 독립 요청을 구성합니다. 각 요청은 최대 50개의 결과를 제공하며, 요청별 검색 조건과 결과 수를 함께 보존합니다.

한 요청 최대 50개 결과
한 요청 최대 50개 결과

학습자가 쓸 시간과 배울 일을 정하기

교육 영상 후보를 찾기 전에 학습자가 어떤 일을 할 수 있게 되어야 하는지 정합니다. 예를 들어 표 계산 도구의 기본 정렬을 익히는 자료와 팀 문서를 공동 편집하는 자료는 검색어와 확인 질문이 다릅니다. 학습 가능한 시간이 짧다면 길이 조건을 활용하되 실제 설명의 완결성은 담당자가 영상을 보고 확인합니다. 준비표에는 학습 목표, 예상 시청 시간, 필요한 선행 지식, 확인할 실습 결과를 적습니다. 이 기준을 먼저 정하면 검색 결과의 조회수만으로 자료를 선택하지 않고 교육의 목적에 맞는 후보를 읽을 수 있습니다. 검색 기능을 실제 학습 경험의 출발점에 연결하는 방식입니다.

검색어와 조건을 한 묶음으로 기록하기

키워드만 저장하기보다 결과 종류와 업로드 시기, 길이, 정렬을 함께 기록합니다. 같은 주제라도 최신 화면 설명을 찾는 검색과 개념을 이해할 자료를 찾는 검색은 조건이 달라질 수 있습니다. 예를 들어 기본 기능의 짧은 시연은 video와 짧은 길이 구간으로, 연속 학습 자료는 playlist로 별도 후보를 확보할 수 있습니다. 각 요청에 조사 목적을 붙이고 반환된 결과를 그 목적에 연결하세요. 검색 결과의 순서가 어떤 조건에서 나온 것인지 남기면 다른 담당자가 같은 자료를 이해하기 좋습니다. 검색어를 바꿔 추가 요청한 경우도 처음 목록의 다음 페이지처럼 합치기보다 독립된 조사 조건으로 보존합니다.

결과 종류에 맞는 항목을 읽기

검색 결과의 type을 먼저 확인하고 항목별로 제공되는 값을 읽습니다. 영상과 쇼츠는 길이와 조회수, 채널 정보를 살펴보고 채널 결과는 핸들과 구독자 정보, 재생목록은 영상 수와 채널을 참고합니다. 제공되지 않은 값은 빈 상태로 보존하고 다른 항목의 값을 임의로 채우지 않습니다. 길이가 짧다는 사실과 쇼츠 형식이라는 구분도 결과의 실제 type에 맞춰 읽으세요. 큐레이션 화면에는 영상 링크와 학습 목적을 먼저 보여 주고 조사를 위한 부가 정보는 별도 영역에 둘 수 있습니다. 검색 결과를 한 종류의 데이터처럼 평평하게 합치지 않으면 서로 다른 자료의 역할을 명확하게 설명하기 좋습니다.

길이 구간과 쇼츠 형식 구분
길이 구간과 쇼츠 형식 구분

실제 시청으로 교육 적합성 확인하기

후보 영상은 담당자가 실제로 시청하며 교육 목표와 설명 수준을 확인합니다. 화면에 나오는 제품 버전, 실습의 시작 조건, 설명하는 기능의 범위를 기록하세요. 영상 제목이 목표와 같더라도 필요한 과정이 어느 구간에 있는지 확인하는 것이 좋습니다. 학습 카드에는 왜 이 영상을 골랐는지, 보기 전에 준비할 자료는 무엇인지, 시청 후 무엇을 해 보면 좋은지 자체 문장으로 적습니다. 다른 사람의 영상 내용을 복제하는 대신 원래 링크와 출처를 연결해 학습자가 자료를 찾아볼 수 있도록 합니다. 공개 검색 결과와 실제 교육 적합성의 판단이 이어지는 단계입니다.

후보를 학습 순서로 재구성하기

선정한 자료를 단순 인기순으로 나열하기보다 개념 이해, 짧은 시연, 직접 실습의 순서로 배치할 수 있습니다. 각 자료의 역할을 한 문장으로 설명하고 앞 자료에서 배운 내용이 다음 실습에 어떻게 이어지는지 적습니다. 같은 기능을 다루는 여러 후보가 있다면 설명의 깊이와 필요한 준비물을 비교해 대상 학습자에게 맞는 자료를 선택하세요. 선택하지 않은 후보도 조사 기록으로 남기면 다음 과정에서 참고하기 좋습니다. 최종 큐레이션에는 실제 시청하고 확인한 날짜를 표시합니다. 교육 환경이 바뀌었을 때 어느 자료를 다시 확인해야 하는지 찾기 쉬워집니다.

후보 검색 뒤 담당자 검토
후보 검색 뒤 담당자 검토

에이픽 검색을 교육 조사에 연결하는 이유

에이픽은 키워드뿐 아니라 종류·기간·길이·정렬을 함께 지정해 구조화된 결과를 받는 기능을 제공합니다. 담당자는 학습 목적별 검색 조건을 설계하고 결과의 ID와 URL을 자료 관리 화면에 연결할 수 있습니다. 정상 검색 건당 공개 단가가 있어 주제 수와 조건별 요청 횟수에 맞춰 조사 예산을 계획하기 좋습니다. 도입 효과는 후보 조사 조건이 명확해졌는지, 선택 이유와 실제 시청 검토가 연결되는지로 살펴보세요. 주제별 후보 목록과 담당자의 검토 기록이 같은 자료에 모이면 다음 교육 회차에도 선정 근거를 이어 활용할 수 있습니다. 검색과 교육 판단을 나누면 자료 확보의 반복 작업과 교육 설계의 고유 판단을 각각 관리하기 좋습니다.

첫 학습 카드의 완성 기준

첫 카드에는 학습 목표, 영상 URL, 실제 확인한 내용, 필요한 준비물, 시청 후 실습을 넣어 보세요. 검색 조건과 확인 날짜는 내부 기록에 연결합니다. 학습자가 이 카드만 보고 무엇을 배우고 어떤 행동을 해야 하는지 이해하는지 검토합니다. 화면이나 내용의 사용 권한이 필요한 별도 활용은 해당 범위에서 확인하고, 기본 큐레이션에서는 원래 자료의 출처와 링크를 명확하게 유지하세요.

다음 페이지 대신 조건별 요청
다음 페이지 대신 조건별 요청

공개 단가와 이용 조건

공개 기본 단가는 정상 검색 건당 20P입니다. 학습 주제와 조건을 달리한 검색 7회의 계획 비용은 7회×20P=140P입니다. 결과 수가 0인 정상 응답도 과금되며 입력 오류·시간 초과 등 실패 응답은 api.cost 0입니다. 실제 차감은 응답 api.cost에서 확인합니다. 1P는 1원이며 부가세는 별도입니다. 정확한 업로드일·좋아요 수 등 별도 영상 정보 조회가 필요한 항목은 해당 기능과 비용을 구분해 계획하세요.

우리 업무에 연결하는 시작점

에이픽 공식 개발가이드의 입력 예제와 응답 항목을 확인하고 이번 업무에서 필요한 값을 선택하세요. 이 글의 사례는 실제 기능에 기반한 업무 적용 기획입니다. 우리 조직의 자료를 어떤 값으로 입력하고 어떤 반환 항목을 화면이나 문서에 연결할지 정하면 첫 적용 범위가 구체적으로 드러납니다. 결과의 확인 시점과 판단 근거를 함께 남겨 다음 담당자도 같은 흐름으로 활용할 수 있게 구성하세요.

에이픽 공식 화면(2026-11-16 확인)
에이픽 공식 화면(2026-11-16 확인)

첫 작업을 시작해 보세요

에이픽의 공식 화면에서 이 글에서 확인한 항목을 직접 비교해 보세요.

에이픽에서 API 기능 확인하기

#에이픽 #유튜브검색API #교육큐레이션 #학습영상 #길이조건 #검색조건 #학습카드 #콘텐츠조사

댓글 없음:

댓글 쓰기