API iQIYI Альбом
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Находите сериалы и фильмы в международном каталоге iQIYI по названию или имени актёра. Получайте список эпизодов, общее и доступное число эпизодов, год, дату выхода, рейтинг и возрастной рейтинг. Каталоги различаются в зависимости от библиотеки, выбранной в region. Доступ к просмотру не гарантируется.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra iQIYI Альбом (iqiyi/album).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: iqiyi и action: album, а параметры передайте в params.
- Обязательные параметры:
- keyword: Поисковый запрос для действия search либо названия сериалов и альбомов или имена актёров для международного действия album.
- Необязательные параметры:
- lang: Задаёт язык отображения названий для действия album с помощью кратких кодов: zhcn, zhtw, enus, jajp, arsa, eses, idid, kokr, msmy, thth или vivn. (допустимые значения: arsa / enus / eses / idid / jajp / kokr / msmy / thth)
- language: Код языка для локализации названий в действии album (параметр совместимости): zh_cn (по умолчанию), zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es или ar_sa. (допустимые значения: ar_sa / en_us / es_es / id_id / ja_jp / ko_kr / ms_my / th_th)
- region: Выбирает регион каталога для действия album: intl (по умолчанию), vn, th, id, my, tw, ph, sg, kr или jp. Любое другое значение возвращает 422. Параметр меняет региональный каталог медиа, а не язык интерфейса. (допустимые значения: id / intl / jp / kr / my / ph / sg / th)
- limit: Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 10)
- Возвращает список записей. Основные поля каждой записи: id, url, play_url, title, subtitle, type, is_series, year, release_date, duration_seconds, duration_sec, rating; всего полей: 19, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=iqiyi.
- Пример тела запроса:
{
"platform": "iqiyi",
"action": "album",
"params": {
"keyword": "电影"
}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | iqiyi | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | album | Идентификатор возможности, фиксированное значение. |
keyword | body.params | string | Да | - | Поисковый запрос для действия search либо названия сериалов и альбомов или имена актёров для международного действия album. Действие album не получает данные напрямую по URL альбомов, а доступные каталоги зависят от региона. |
lang | body.params | string (enum) | Нет | - | Задаёт язык отображения названий для действия album с помощью кратких кодов: zhcn, zhtw, enus, jajp, arsa, eses, idid, kokr, msmy, thth или vivn. Параметр меняет локализованные подписи метаданных, но не запрашивает субтитры к видео и не меняет регион библиотеки контента.Допустимые значенияarsaenusesesididjajpkokrmsmyththvivnzhcnzhtw |
language | body.params | string (enum) | Нет | - | Код языка для локализации названий в действии 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 | body.params | string (enum) | Нет | - | Выбирает регион каталога для действия album: intl (по умолчанию), vn, th, id, my, tw, ph, sg, kr или jp. Любое другое значение возвращает 422. Параметр меняет региональный каталог медиа, а не язык интерфейса.Допустимые значенияidintljpkrmyphsgthtwvn |
limit | body.params | integer (1–50) | Нет | 10 | Максимальное число записей в этом вызове, целое число от 1 до 50. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств. |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "iqiyi",
"action": "album",
"params": {
"keyword": "电影"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "iqiyi",
"action": "album",
"results": [
{
"id": "•••",
"play_url": "https://www.iq.com/play/%E5%B0%8F%E7%BE%8A%E8%82%96%E6%81%A9%E5%A4%A7%E7%94%B5%E5%BD%B1-2015-19rro5fml8?lang=zh_cn",
"title": "小羊肖恩大电影",
"type": "Movie",
"is_series": false,
"year": 2015,
"release_date": "2015-07-17",
"duration_seconds": 5103,
"rating": 8.2,
"content_rating": "13+",
"image_url": "http://pic2.iqiyipic.com/image/20251202/cf/44/v_109440751_m_601_m11.jpg",
"cast": [
{
"name": "贾斯汀·弗莱彻",
"role": "mainActor",
"url": "https://www.iq.com/star/%E8%B4%BE%E6%96%AF%E6%B1%80-%E5%BC%97%E8%8E%B1%E5%BD%BB-justin-fletcher-216368005?lang=zh_cn",
"image_url": "http://pic4.iqiyipic.com/image/20250606/5c/6c/p_216368005_m_601.jpg"
},
{
"name": "约翰·斯帕克斯",
"role": "mainActor",
"url": "https://www.iq.com/star/%E7%BA%A6%E7%BF%B0-%E6%96%AF%E5%B8%95%E5%85%8B%E6%96%AF-john-sparkes-216368105?lang=zh_cn",
"image_url": "http://pic9.iqiyipic.com/image/20250606/a8/94/p_216368105_m_601.jpg"
},
{
"name": "欧米德·吉亚李利",
"role": "mainActor",
"url": "https://www.iq.com/star/%E6%AC%A7%E7%B1%B3%E5%BE%B7-%E5%90%89%E4%BA%9A%E6%9D%8E%E5%88%A9-omid-djalili-214853005?lang=zh_cn",
"image_url": "http://pic1.iqiyipic.com/image/20250613/a1/97/p_214853005_m_601_m1.jpg"
}
],
"platform": "iqiyi",
"rating_scale": 10
},
{
"id": "•••",
"play_url": "https://www.iq.com/play/%E8%BF%98%E6%98%9F%E7%88%B7%E4%B8%80%E9%83%A8%E7%94%B5%E5%BD%B1-2017-19rr986tjo?lang=zh_cn",
"title": "还星爷一部电影",
"type": "Movie",
"is_series": false,
"year": 2017,
"release_date": "2017-06-27",
"duration_seconds": 3720,
"rating": 4.5,
"content_rating": "13+",
"image_url": "http://pic5.iqiyipic.com/image/20220819/d4/9d/v_111181663_m_601_m7.jpg",
"cast": [
{
"name": "闫志鹏",
"role": "mainActor",
"url": "https://www.iq.com/star/%E9%97%AB%E5%BF%97%E9%B9%8F-yan-zhi-peng-208619205?lang=zh_cn",
"image_url": "http://pic6.iqiyipic.com/image/20250606/5e/02/p_208619205_m_601.jpg"
},
{
"name": "杨能",
"role": "actor",
"url": "https://www.iq.com/star/%E6%9D%A8%E8%83%BD-yang-neng-232678205?lang=zh_cn",
"image_url": "http://pic0.iqiyipic.com/image/20250605/ad/ba/p_232678205_m_601.jpg"
},
{
"name": "张美娥",
"role": "actor",
"url": "https://www.iq.com/star/%E5%BC%A0%E7%BE%8E%E5%A8%A5-zhang-mei-e-231928105?lang=zh_cn",
"image_url": "http://pic6.iqiyipic.com/image/20250605/6f/3b/p_231928105_m_601.jpg"
}
],
"platform": "iqiyi",
"rating_scale": 10
}
],
"count": 10,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
url | Ссылка на запись на платформе. |
play_url | Трактуется так же, как на самой платформе |
title | Заголовок. null, если на платформе нет заголовков (например, у текстовых постов). |
subtitle | Трактуется так же, как на самой платформе |
type | Тип записи; значения зависят от возможности (например, video / image / text). |
is_series | Трактуется так же, как на самой платформе |
year | Трактуется так же, как на самой платформе |
release_date | Трактуется так же, как на самой платформе |
duration_seconds | Длительность в секундах. null для контента, который не является видео или аудио. |
duration_sec | Трактуется так же, как на самой платформе |
rating | Рейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным. |
rating_scale | Максимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг. |
content_rating | Трактуется так же, как на самой платформе |
episode_count | Трактуется так же, как на самой платформе |
episode_available_count | Трактуется так же, как на самой платформе |
image_url | Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls. |
episodes | Трактуется так же, как на самой платформе |
cast | Трактуется так же, как на самой платформе |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- iQIYI International: региональные ограничения, связанные с авторскими правами, и актуальный каталог ↗
В ответах на часто задаваемые вопросы iQIYI International об ограничениях, связанных с авторскими правами, поясняется, что региональное лицензирование может препятствовать воспроизведению, а результаты внешнего поиска могут не отражать актуальный каталог. Поэтому доступные варианты региона альбома и полученные метаданные не гарантируют права на воспроизведение и тем более не позволяют обходить региональные ограничения.
Проверено 2026-09-04