API de Álbum de iQIYI

POST

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

Localiza un álbum o serie mediante keyword, con idioma y región opcionales, y devuelve episodios, estado, año y duración. No garantiza catálogo idéntico entre regiones ni acceso de reproducción.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a iqiyi y action igual a album. Precio $1.39 por 1.000 solicitudes ($0.001389 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra iQIYI: Álbum (iqiyi/album).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en iqiyi y action en album, y los parámetros dentro de params.
- Parámetros obligatorios:
  - keyword: search busca videos de iQIYI; album busca información de series, episodios y actores en el sitio internacional por el nombre de la serie o palabras clave del álbum.
- Parámetros opcionales:
  - lang: Idioma del título para album, usa los códigos compactos listados en esta API, como zhcn (chino simplificado), zhtw (chino tradicional), enus (inglés), jajp (japonés). (valores admitidos: arsa / enus / eses / idid / jajp / kokr / msmy / thth)
  - language: Parámetro de compatibilidad de idioma para album, usa zh_cn, zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es, ar_sa; por defecto zh_cn. Si también existe lang, finalmente prevalecerá lang. (valores admitidos: ar_sa / en_us / es_es / id_id / ja_jp / ko_kr / ms_my / th_th)
  - region: Región de la biblioteca de videos para album: intl (biblioteca internacional, predeterminado), vn (Vietnam), th (Tailandia), id (Indonesia), my (Malasia), tw (Taiwán), ph (Filipinas), sg (Singapur), kr (Corea del Sur), j… (valores admitidos: id / intl / jp / kr / my / ph / sg / th)
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 50. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 10)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, play_url, title, subtitle, type, is_series, year, release_date, duration_seconds, duration_sec, rating; 19 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=iqiyi.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "iqiyi",
  "action": "album",
  "params": {
    "keyword": "电影"
  }
}
- Precio: $1.39 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíiqiyiIdentificador de la plataforma, valor fijo.
actionbodystringSíalbumIdentificador de la capacidad, valor fijo.
keywordbody.paramsstringSí-search busca videos de iQIYI; album busca información de series, episodios y actores en el sitio internacional por el nombre de la serie o palabras clave del álbum. album no es una consulta directa de detalles de la URL del álbum, y no garantiza que la biblioteca de videos sea la misma en todas las regiones.
langbody.paramsstring (enum)No-Idioma del título para album, usa los códigos compactos listados en esta API, como zhcn (chino simplificado), zhtw (chino tradicional), enus (inglés), jajp (japonés). No es una solicitud de traducción de subtítulos, ni controla la región de la biblioteca de videos.Valores permitidosarsaenusesesididjajpkokrmsmyththvivnzhcnzhtw
languagebody.paramsstring (enum)No-Parámetro de compatibilidad de idioma para album, usa zh_cn, zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es, ar_sa; por defecto zh_cn. Si también existe lang, finalmente prevalecerá lang; los formatos de ambos parámetros no se pueden mezclar.Valores permitidosar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw
regionbody.paramsstring (enum)No-Región de la biblioteca de videos para album: intl (biblioteca internacional, predeterminado), vn (Vietnam), th (Tailandia), id (Indonesia), my (Malasia), tw (Taiwán), ph (Filipinas), sg (Singapur), kr (Corea del Sur), jp (Japón). Cualquier otro valor devuelve 422. No es una selección de idioma de la página.Valores permitidosidintljpkrmyphsgthtwvn
limitbody.paramsinteger (1–50)No10Número máximo de filas que devuelve esta llamada, un entero de 1 a 50. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro.

Ejemplos de código

#
bash
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": "电影"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

#
Obtenida el 26 de septiembre de 2026, 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "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": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
play_urlConserva el significado de la plataforma
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
subtitleConserva el significado de la plataforma
typeTipo de registro; los valores dependen de la capacidad (por ejemplo video / image / text).
is_seriesConserva el significado de la plataforma
yearConserva el significado de la plataforma
release_dateConserva el significado de la plataforma
duration_secondsDuración en segundos. null en contenido que no es video ni audio.
duration_secConserva el significado de la plataforma
ratingValoración. La escala depende de la plataforma: rating_scale en la misma fila indica el máximo (normalmente 5; Booking, Douban, iQIYI y NAVER usan 10). Convierte con rating_scale antes de comparar entre plataformas o la comparación puede salir al revés.
rating_scaleMáximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating.
content_ratingConserva el significado de la plataforma
episode_countConserva el significado de la plataforma
episode_available_countConserva el significado de la plataforma
image_urlEnlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
episodesConserva el significado de la plataforma
castConserva el significado de la plataforma
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Referencias oficiales

#

Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.

  • iQIYI Internacional: restricciones regionales de derechos de autor y catálogo actual ↗

    Las preguntas frecuentes sobre derechos de autor de iQIYI Internacional indican que las licencias regionales pueden impedir la reproducción del contenido, y que los resultados de búsquedas externas no siempre reflejan el catálogo actual. Por tanto, las opciones de región de `album` y los metadatos recuperados no garantizan los permisos de reproducción, ni mucho menos permiten eludir las restricciones geográficas.

    Comprobado el 2026-09-04

Google Analytics solo si aceptas. Privacidad