플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Youku 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
| 기능 | 설명 | 1,000건당 | 24시간 상태 |
|---|---|---|---|
검색search | 키워드로 Youku의 프로그램, 시리즈, 동영상을 호출당 최대 150개까지 찾습니다. | 요청 1,000개당 $1.39 | 정상 |
동영상 상세 정보video | ID로 Youku 동영상이나 프로그램을 조회합니다. | 요청 1,000개당 $1.39 | 정상 |
프로필profile | 인코딩된 크리에이터 ID로 Youku 크리에이터를 확인합니다. | 요청 1,000개당 $1.39 | 정상 |
트랜스크립트transcript | Youku 동영상의 스크립트를 추출하며, 언어, 재생 시간, 작성자, 반환되는 경우 번역본이 포함됩니다. | 요청 1,000개당 $2.78 | 정상 |
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Youku 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 Youku의 프로그램, 시리즈, 동영상을 호출당 최대 150개까지 찾습니다. 카테고리, 공개일, 완결 여부, 코너 배지, 썸네일을 가져옵니다. 댓글은 검색하지 않습니다. 재생하지 않으며 지역별 시청 가능 여부도 확인하지 않습니다. | keyword | — | Sync 응답 | 카탈로그 값: defaultLimit=30, maxLimit=150. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · subtitle · category · source_name · release_date · is_completed · corner_tag · thumbnail_url · platform |
video동영상 상세 정보 ID로 Youku 동영상이나 프로그램을 조회합니다. 제목, 프로그램 이름, 에피소드 수, 재생 시간, VIP 여부, 댓글·좋아요 수, 작성자를 가져옵니다. 작성자 UID가 아닌, 검색 결과의 프로그램 ID나 동영상 ID 또는 id_ 페이지 링크를 전달합니다. 댓글과 재생은 포함되지 않습니다. | id | — | Sync 응답 | — | 요청 1,000개당 $1.39 | id · show_id · url · title · show_name · subtitle · category · video_type · duration_seconds · duration_sec · episode_total · episode_last · is_completed · comment_count · like_count · is_vip · allow_comment · posted_at · show_release_time · thumbnail_url · tags · author_id · author_name · author_avatar_url · author_follower_count · author_url · platform |
profile프로필 인코딩된 크리에이터 ID로 Youku 크리에이터를 확인합니다. 이름, 소개, 성별, 위치, 팔로워·좋아요 수, 인증 설명을 가져옵니다. 사용자 이름, 프로그램 ID, 채널 URL이 아닌, 동영상 작성자 데이터의 인코딩된 UID를 사용해야 합니다. 비공개 분석 데이터는 제공되지 않습니다. | user_id | — | Sync 응답 | — | 요청 1,000개당 $1.39 | user_id · numeric_id · name · url · bio · avatar_url · gender · like_count · follower_count · is_verified · verified_desc · location · platform |
transcript트랜스크립트 Youku 동영상의 스크립트를 추출하며, 언어, 재생 시간, 작성자, 반환되는 경우 번역본이 포함됩니다. 처리는 비동기식이며, 회원 전용 동영상은 지원하지 않고 모든 동영상에 스크립트가 있는 것은 아닙니다. | url | — | Async 응답 | — | 요청 1,000개당 $2.78 | title · text · language · translated_text · translated_language · duration_seconds · duration_sec · author_name · author_id · author_url · thumbnail_url · tags · platform |
Youku search 파라미터는 각각 무엇을 의미하나요?
키워드로 Youku의 프로그램, 시리즈, 동영상을 호출당 최대 150개까지 찾습니다. 카테고리, 공개일, 완결 여부, 코너 배지, 썸네일을 가져옵니다. 댓글은 검색하지 않습니다. 재생하지 않으며 지역별 시청 가능 여부도 확인하지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태keyword필수- search 액션으로 Youku의 프로그램, 시리즈, 동영상을 검색할 검색어입니다. 동영상 댓글은 검색하지 않습니다.
Youku video 파라미터는 각각 무엇을 의미하나요?
ID로 Youku 동영상이나 프로그램을 조회합니다. 제목, 프로그램 이름, 에피소드 수, 재생 시간, VIP 여부, 댓글·좋아요 수, 작성자를 가져옵니다. 작성자 UID가 아닌, 검색 결과의 프로그램 ID나 동영상 ID 또는 id_ 페이지 링크를 전달합니다. 댓글과 재생은 포함되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태id필수- video 액션에 필요한 프로그램 ID(showId) 또는 동영상 ID(vid)로, 검색 결과나 id_...html 형식의 동영상 페이지 URL에서 추출할 수 있습니다. 인코딩된 UGC ID는 시리즈 해시와 다르므로 UGC ID를 우선 사용하세요. 작성자 UID가 아닙니다.Youku: 동영상 메타데이터와 콘텐츠 라이선스 범위 — Youku 이용약관은 시청, 캐싱, 검색, 댓글 등 플랫폼 기능을 구분하고 콘텐츠 복제, 배포, 다운로드에 제한을 둡니다. 여기서 인용한 이용 범위에 따라, 읽을 수 있는 프로그램이나 동영상 상세 정보가 재생, 다운로드, 재게시 권한이나 Youku의 공식 보증을 의미하지는 않습니다. · 확인일
Youku profile 파라미터는 각각 무엇을 의미하나요?
인코딩된 크리에이터 ID로 Youku 크리에이터를 확인합니다. 이름, 소개, 성별, 위치, 팔로워·좋아요 수, 인증 설명을 가져옵니다. 사용자 이름, 프로그램 ID, 채널 URL이 아닌, 동영상 작성자 데이터의 인코딩된 UID를 사용해야 합니다. 비공개 분석 데이터는 제공되지 않습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태user_id필수- profile 액션에 필요한 인코딩된 크리에이터 UID로, 동영상 작성자 메타데이터에서 가져옵니다. 사용자 이름, 프로그램 ID, 채널 홈페이지 전체 URL은 입력하지 마세요.
Youku transcript 파라미터는 각각 무엇을 의미하나요?
Youku 동영상의 스크립트를 추출하며, 언어, 재생 시간, 작성자, 반환되는 경우 번역본이 포함됩니다. 처리는 비동기식이며, 회원 전용 동영상은 지원하지 않고 모든 동영상에 스크립트가 있는 것은 아닙니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- transcript 액션에 필요한 공개 동영상 URL입니다. 처리는 비동기로 진행되며 완료된 후에 결과가 반환됩니다. 회원 전용 콘텐츠는 지원하지 않습니다. video 액션은 id_...html 링크에서 식별자를 추출할 수 있지만, 공개 액션에는 여전히 이 URL을 명시해야 합니다.Youku: 자동 스크래핑과 VIP 콘텐츠 접근 제한 — Youku 이용약관이 금지하는 행위에는 플랫폼 콘텐츠의 자동 수집 또는 처리와, 저작권 보호 조치를 무력화해 비VIP 사용자가 VIP 콘텐츠를 얻게 하는 행위가 포함됩니다. 이 페이지에서 공개 동영상을 텍스트로 변환하는 것은 플랫폼의 승인이 아니며, VIP, 저작권, 접근 제한을 우회한다고 보장하지 않습니다. 사용 전에 관련 라이선스를 확인해야 합니다. · 확인일
Youku 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":"youku","action":"search","params":{"keyword":"<keyword>"}}'
Youku API 자주 묻는 질문
Youku API로 무엇을 가져올 수 있나요?
platform을 youku 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 동영상 상세 정보, 프로필 및 트랜스크립트입니다. 각 액션 이름은 서로 다른 Youku 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Youku search 요청에는 어떤 입력이 필요한가요?
search 액션으로 Youku의 프로그램, 시리즈, 동영상을 검색할 검색어입니다. 동영상 댓글은 검색하지 않습니다. params 안의 keyword 필드로 전달하세요.
Youku search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, subtitle, category 및 source_name입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Youku 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답 및 async 응답입니다.