플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 iQIYI 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
iQIYI 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 키워드로 iQIYI 프로그램과 동영상을 검색하고 카테고리, 게시 기간, 화질, 출처 사이트, 정렬로 필터링하며, 재생 시간, 인기 지수, 평점, 시리즈, 출연진을 가져옵니다. | keyword | category, publish_date, published, quality, scrape_additional_info, site, sort | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · category · category_id · duration_seconds · duration_sec · heat_count · rating · rating_scale · rating_count · like_count · comment_count · collect_count · album_id · album_title · album_url · album_episode_count · image_url · wide_image_url · author_name · author_id · author_avatar_url · author_follower_count · author_video_count · author_location · author_org · posted_at · platform · cast |
video동영상 상세 정보 재생 | url | scrape_additional_info | Sync 응답 | — | 요청 1,000개당 $1.39 | id · url · title · text · category · category_id · duration_seconds · duration_sec · heat_count · rating · rating_scale · rating_count · like_count · comment_count · collect_count · album_id · album_title · album_url · album_episode_count · image_url · wide_image_url · author_name · author_id · author_avatar_url · author_follower_count · author_video_count · author_location · author_org · posted_at · platform · cast |
album앨범 제목이나 출연진 이름으로 iQIYI 국제판 카탈로그에서 시리즈나 영화를 찾습니다. 에피소드 목록, 전체 및 시청 가능 에피소드 수, 연도, 공개일, 평점, 시청 등급을 가져옵니다. 카탈로그는 | keyword | lang, language, region | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · play_url · title · subtitle · type · is_series · year · release_date · duration_seconds · duration_sec · rating · rating_scale · content_rating · episode_count · episode_available_count · image_url · episodes · cast · platform |
iQIYI search 파라미터는 각각 무엇을 의미하나요?
키워드로 iQIYI 프로그램과 동영상을 검색하고 카테고리, 게시 기간, 화질, 출처 사이트, 정렬로 필터링하며, 재생 시간, 인기 지수, 평점, 시리즈, 출연진을 가져옵니다. heat_count는 재생 수가 아닌 iQIYI 자체 인기 점수이며, 다른 플랫폼과 비교할 수 없습니다.
keyword필수- search 액션에서는 검색어를, 해외판 album 액션에서는 시리즈, 앨범, 출연진 이름을 지정합니다. album 액션은 앨범 URL에서 상세 정보를 직접 가져오지 않으며, 이용 가능한 콘텐츠 라이브러리는 지역마다 다릅니다.iQIYI: 콘텐츠 인기 지수와 사이트 내 재생 수는 어떻게 다른가 — iQIYI의 2018년 공지는 콘텐츠 인기 지수를 조회, 상호작용, 공유를 아우르는 복합 지표로 설명하며 재생 수와 구분합니다. 이는 heat_count의 지표 유형만 설명할 뿐이며, 현재 알고리즘, 기준값, 플랫폼 간 비교 가능성을 추정하거나 인기 지수로 실제 재생 수를 추론하지 않습니다. · 확인일
category선택- 동영상 콘텐츠를 카테고리별로 필터링합니다. 허용되는 값에는 movie, tv_series, variety_shows, animation, documentary, advertisement, beauty, car, comedy, entertainment, fashion, finance, game, health, life, military, mother_baby, music, news_info, originals, short_films, sports, square_dance, talk_shows, technology, trailers, travel, trending, all(제한 없음) 등이 있습니다. 이 파라미터는 출연진이나 시리즈 태그가 아닌 넓은 범주의 카테고리를 기준으로 필터링합니다.허용 값:
advertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows publish_date선택- search 액션 결과를 게시 기간으로 필터링하며, all, last_24_hours, last_7_days, last_30_days를 받습니다. YYYY-MM-DD 형식의 날짜는 받지 않으며, 이 필드와 published가 모두 있으면 published가 우선합니다.
published선택- search 액션에서 publish_date보다 우선하며, all, last_24_hours, last_7_days, last_30_days를 받습니다. 문자열 필터이며 불리언 true/false 값은 받지 않습니다.
quality선택- 요청한 동영상 화질로 iQIYI 검색 결과를 필터링합니다. 일반적인 값은 all, hd, ultra_hd, 720p, 1080p입니다. 다운로드나 트랜스코딩 옵션이 아니며, 목록에 없는 값은 효과가 없을 수 있습니다.
scrape_additional_info선택- iQIYI 검색 결과에 업로더와 참여 지표 정보를 추가로 포함할지 제어합니다. JSON 불리언으로 전달하며 기본값은 true입니다. false로 설정하면 추가 조회를 하지 않지만 EveryInfra API 가격은 바뀌지 않습니다.
site선택- 검색에 적용할 소스 사이트 조건을 지정합니다. 일반적인 값은 all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv, m1905입니다. 검색 결과를 해당 사이트로 좁힐 뿐이며, 각 사이트에 상세 액션이 있다는 의미는 아닙니다.
sort선택- 동영상 검색 결과의 정렬 순서를 제어하며, relevance, newest, popular를 받습니다. 사용자 평점이나 회차 공개 순서로는 정렬하지 않으며, 단일 동영상을 요청할 때는 효과가 없습니다.허용 값:
newestpopularrelevance
iQIYI video 파라미터는 각각 무엇을 의미하나요?
재생 url 하나로 iQIYI 동영상 상세 정보를 JSON으로 가져옵니다. 레코드에는 제목, 카테고리, 재생 시간, 게시일, 인기 지수, 평점, 시리즈 정보, 출연진, 업로더가 포함됩니다. 개별 동영상 재생 링크를 전달하세요. 시리즈 페이지와 크리에이터 프로필은 지원하지 않습니다. 시리즈를 찾으려면 album을 사용하세요.
url필수- video 액션에서 iQIYI 동영상 재생 페이지 전체 URL(v_*.html 형식)을 받습니다. 시리즈/앨범 페이지(a_*.html)와 크리에이터 프로필 링크는 지원하지 않으며, 시리즈를 찾으려면 keyword와 함께 album 액션을 사용합니다.
scrape_additional_info선택- iQIYI 검색 결과에 업로더와 참여 지표 정보를 추가로 포함할지 제어합니다. JSON 불리언으로 전달하며 기본값은 true입니다. false로 설정하면 추가 조회를 하지 않지만 EveryInfra API 가격은 바뀌지 않습니다.
iQIYI album 파라미터는 각각 무엇을 의미하나요?
제목이나 출연진 이름으로 iQIYI 국제판 카탈로그에서 시리즈나 영화를 찾습니다. 에피소드 목록, 전체 및 시청 가능 에피소드 수, 연도, 공개일, 평점, 시청 등급을 가져옵니다. 카탈로그는 region에서 선택한 라이브러리에 따라 다릅니다. 재생 가능 여부는 보장되지 않습니다.
keyword필수- search 액션에서는 검색어를, 해외판 album 액션에서는 시리즈, 앨범, 출연진 이름을 지정합니다. album 액션은 앨범 URL에서 상세 정보를 직접 가져오지 않으며, 이용 가능한 콘텐츠 라이브러리는 지역마다 다릅니다.
lang선택- album 액션의 제목 표시 언어를 축약 코드로 지정합니다: zhcn, zhtw, enus, jajp, arsa, eses, idid, kokr, msmy, thth, vivn. 이 파라미터는 현지화된 메타데이터 레이블만 변경하며, 동영상 자막을 요청하거나 콘텐츠 라이브러리 지역을 바꾸지 않습니다.허용 값:
arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw language선택- album 액션의 제목 현지화에 사용할 호환용 언어 코드로, zh_cn(기본값), zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es, ar_sa 중 하나를 받습니다. 이 파라미터와 lang을 모두 지정하면 lang이 우선하며, 두 파라미터의 코드 형식을 섞어 쓰면 안 됩니다.허용 값:
ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw region선택- album 액션의 콘텐츠 라이브러리 지역을 선택합니다: intl(기본값), vn, th, id, my, tw, ph, sg, kr, jp. 그 외의 값은 422를 반환합니다. 이 파라미터는 인터페이스 언어가 아닌 지역별 미디어 카탈로그를 변경합니다.허용 값:
idintljpkrmyphsgthtwvniQIYI International: 지역별 저작권 제한과 현재 제공 콘텐츠 — iQIYI International의 저작권 제한 관련 도움말 FAQ에 따르면, 지역별 라이선스로 인해 콘텐츠를 재생할 수 없을 수 있으며 외부 검색 결과가 현재 제공 중인 콘텐츠 목록과 다를 수 있습니다. 따라서 앨범 지역 옵션과 조회된 메타데이터는 재생 가능 여부를 보장하지 않으며, 지역 제한을 우회하는 방법은 더더욱 아닙니다. · 확인일
iQIYI 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":"iqiyi","action":"search","params":{"keyword":"<keyword>"}}'
iQIYI API 자주 묻는 질문
iQIYI API로 무엇을 가져올 수 있나요?
platform을 iqiyi 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 동영상 상세 정보 및 앨범입니다. 각 액션 이름은 서로 다른 iQIYI 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
iQIYI search 요청에는 어떤 입력이 필요한가요?
search 액션에서는 검색어를, 해외판 album 액션에서는 시리즈, 앨범, 출연진 이름을 지정합니다. album 액션은 앨범 URL에서 상세 정보를 직접 가져오지 않으며, 이용 가능한 콘텐츠 라이브러리는 지역마다 다릅니다. params 안의 keyword 필드로 전달하세요.
iQIYI search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, text, category 및 category_id입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 iQIYI 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.