API de iQIYI
Busca programas, álbumes y videos de iQIYI y consulta una pieza por URL. Categoría, idioma y región pertenecen a acciones concretas y no son intercambiables.
Popularidad, valoración y duración son campos públicos del contenido. La presencia en el catálogo no garantiza reproducción, subtítulos o disponibilidad idéntica en todos los mercados.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de iQIYI, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar programas y videos en iQIYIsearch | Busca programas y videos de iQIYI mediante keyword, con categoría, fecha de publicación u orden opcionales. | $1.39 por 1.000 solicitudes | Normal |
Consultar un video de iQIYIvideo | Abre la url de un video de iQIYI y recoge título, categoría, duración, fecha, reparto y métricas publicadas. | $1.39 por 1.000 solicitudes | Normal |
Consultar un álbum o una seriealbum | Localiza un álbum o serie mediante keyword, con idioma y región opcionales, y devuelve episodios, estado, año y duración. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de iQIYI?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar programas y videos en iQIYI Busca programas y videos de iQIYI mediante | keyword | category, publish_date, published, quality, scrape_additional_info, site, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 |
videoConsultar un video de iQIYI Abre la | url | scrape_additional_info | Entrega síncrona | — | $1.39 por 1.000 solicitudes | 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 |
albumConsultar un álbum o una serie Localiza un álbum o serie mediante | keyword | lang, language, region | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 |
¿Qué significan los parámetros de iQIYI search?
Busca programas y videos de iQIYI mediante keyword, con categoría, fecha de publicación u orden opcionales. Devuelve tipo, duración, popularidad y valoración visibles; no reproduce contenido ni confirma disponibilidad regional.
keywordObligatoriosearchbusca videos de iQIYI;albumbusca información de series, episodios y actores en el sitio internacional por el nombre de la serie o palabras clave del álbum.albumno 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.iQIYI: índice de popularidad y reproducciones — iQIYI ha descrito su índice de popularidad como una combinación de visualización, interacción y compartidos, distinta de un contador de reproducciones. La cita no permite deducir el algoritmo actual ni comparar `heat_count` entre plataformas. · ConsultadacategoryOpcional- Categoría de contenido de video.
movie(películas),tv_series(series de TV),variety_shows(programas de variedades),animation(animación),documentary(documentales), etc.; el resto incluye anuncios, automóviles, belleza, entretenimiento, finanzas, juegos, salud, estilo de vida, militar, maternidad/infantil, música, noticias, originales, cortometrajes, deportes, baile de plaza, entrevistas, tecnología, avances, viajes, populares y moda, elige según los valores permitidos de esta API,alles sin límite. No son etiquetas de actores o episodios.Valores permitidos:advertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows publish_dateOpcional- Ventana de tiempo de publicación para
search:all(sin límite),last_24_hours(últimas 24 horas),last_7_days(últimos 7 días),last_30_days(últimos 30 días). No es una fecha en formatoYYYY-MM-DD; si también existepublished,publishedtiene prioridad. publishedOpcional- Parámetro preferente para
publish_date, toma los valoresall/last_24_hours/last_7_days/last_30_days; no es un valor booleano de «si ya está publicado», no puedes enviartrue/false. qualityOpcional- Calidad de reproducción solicitada para la acción
video. Usa únicamente los valores permitidos por esta API; la disponibilidad real depende del contenido y no implica acceso a una calidad protegida o de pago. scrape_additional_infoOpcional- Interruptor booleano para pedir información adicional del autor y de interacción; por defecto
true. Puede aumentar el tiempo de respuesta y no garantiza que todos los campos opcionales estén disponibles. siteOpcional- Sitio o edición regional de iQIYI utilizada por la consulta. No es un idioma de subtítulos ni una autorización para acceder a catálogos restringidos.
sortOpcional- Orden de búsqueda de videos:
relevance(relevancia),newest(más recientes),popular(populares); no es la puntuación de la película ni el orden de reproducción de los episodios. Al especificar un solovideo, no puedes esperar que el orden cambie los detalles.Valores permitidos:newestpopularrelevance
¿Qué significan los parámetros de iQIYI video?
Abre la url de un video de iQIYI y recoge título, categoría, duración, fecha, reparto y métricas publicadas. Los filtros compatibles no convierten esta lectura en búsqueda ni desbloquean contenido restringido.
urlObligatoriovideousa el enlace completo de la página de reproducciónv_*.htmlde iQIYI, no la página del álbuma_*.htmlni el perfil del creador. Para el descubrimiento de álbumes, usaalbum+keyword.scrape_additional_infoOpcional- Interruptor booleano para pedir información adicional del autor y de interacción; por defecto
true. Puede aumentar el tiempo de respuesta y no garantiza que todos los campos opcionales estén disponibles.
¿Qué significan los parámetros de iQIYI album?
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.
keywordObligatoriosearchbusca videos de iQIYI;albumbusca información de series, episodios y actores en el sitio internacional por el nombre de la serie o palabras clave del álbum.albumno 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.langOpcional- Idioma del título para
album, usa los códigos compactos listados en esta API, comozhcn(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 permitidos:arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw languageOpcional- Parámetro de compatibilidad de idioma para
album, usazh_cn,zh_tw,en_us,id_id,ms_my,th_th,vi_vn,ko_kr,ja_jp,es_es,ar_sa; por defectozh_cn. Si también existelang, finalmente prevalecerálang; los formatos de ambos parámetros no se pueden mezclar.Valores permitidos:ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw regionOpcional- 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 permitidos:idintljpkrmyphsgthtwvniQIYI 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. · Consultada
Cómo usar la API de iQIYI
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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>"}}'
Preguntas sobre la API de iQIYI
¿Cómo llamo a la API de iQIYI?
Envía POST /api/v1/social con platform igual a iqiyi, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de iQIYI?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, category y category_id. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de iQIYI?
iQIYI ha descrito su índice de popularidad como una combinación de visualización, interacción y compartidos, distinta de un contador de reproducciones. La cita no permite deducir el algoritmo actual ni comparar heat_count entre plataformas.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; video requiere url; album requiere keyword.
¿Las acciones de iQIYI responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.