Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия iQIYI: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите шоу и видео iQIYI по ключевому слову с фильтрами по категории, периоду публикации, качеству, сайту-источнику или сортировке; в результатах есть длительность, индекс популярности, рейтинг, сериал и актёры. | $1.39 за 1 000 запросов | Норма |
Сведения о видеоvideo | Получайте данные о видео iQIYI в формате JSON по url страницы воспроизведения. | $1.39 за 1 000 запросов | Норма |
Альбомalbum | Находите сериалы и фильмы в международном каталоге iQIYI по названию или имени актёра. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API iQIYI?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите шоу и видео iQIYI по ключевому слову с фильтрами по категории, периоду публикации, качеству, сайту-источнику или сортировке; в результатах есть длительность, индекс популярности, рейтинг, сериал и актёры. | keyword | category, publish_date, published, quality, scrape_additional_info, site, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | 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Сведения о видео Получайте данные о видео iQIYI в формате JSON по | url | scrape_additional_info | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | 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.39 за 1 000 запросов | 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 |
Что означают параметры действия search в API iQIYI?
Ищите шоу и видео 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Необязательный- Переопределяет publish_date в действии search; принимает 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 отключает этот дополнительный запрос, но не меняет стоимость API EveryInfra.
siteНеобязательный- Задаёт условие по сайту-источнику для поиска. Распространённые значения: all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv и m1905. Параметр сужает результаты поиска до этих сайтов и не означает, что для каждого сайта есть действие получения подробной информации.
sortНеобязательный- Задаёт порядок результатов поиска видео: relevance, newest или popular. Не сортирует по оценкам пользователей или порядку выхода серий и не влияет на запрос одного видео.Допустимые значения:
newestpopularrelevance
Что означают параметры действия video в API iQIYI?
Получайте данные о видео iQIYI в формате JSON по url страницы воспроизведения. Запись содержит название, категорию, длительность, дату публикации, индекс популярности, рейтинг, сведения о сериале, актёров и автора загрузки. Передавайте ссылку на страницу воспроизведения отдельного видео. Страницы сериалов и профили авторов не поддерживаются. Для поиска сериала используйте album.
urlОбязательный- Принимает полный URL страницы воспроизведения видео iQIYI (формат v_*.html) для действия video. Страницы сериалов и альбомов (a_*.html) и ссылки на профили авторов не поддерживаются; для поиска сериалов используйте действие album с keyword.
scrape_additional_infoНеобязательный- Определяет, включать ли в результаты поиска iQIYI дополнительные данные об авторе и вовлечённости. Передайте логическое значение JSON; по умолчанию используется true. Значение false отключает этот дополнительный запрос, но не меняет стоимость API EveryInfra.
Что означают параметры действия album в API iQIYI?
Находите сериалы и фильмы в международном каталоге 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 об ограничениях, связанных с авторскими правами, поясняется, что региональное лицензирование может препятствовать воспроизведению, а результаты внешнего поиска могут не отражать актуальный каталог. Поэтому доступные варианты региона альбома и полученные метаданные не гарантируют права на воспроизведение и тем более не позволяют обходить региональные ограничения. · Проверено
Как использовать API iQIYI
- 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>"}}'
Вопросы об API iQIYI
Какие данные можно получить через API iQIYI?
Укажите в platform значение iqiyi. В текущем каталоге: поиск, сведения о видео и альбом. Эти названия действий соответствуют разным объектам или представлениям iQIYI; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе iQIYI?
Поисковый запрос для действия search либо названия сериалов и альбомов или имена актёров для международного действия album. Действие album не получает данные напрямую по URL альбомов, а доступные каталоги зависят от региона. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе iQIYI?
Объявленная схема включает title, text, category и category_id. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия iQIYI возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.