API iQIYI Album
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Normale
Ultime 24 ore
Ultimi 30 giorni
Trova una serie o un film nel catalogo internazionale di iQIYI per titolo o nome di un membro del cast. Ottieni elenco degli episodi, episodi totali e disponibili, anno, data di uscita, valutazione e classificazione dei contenuti. I cataloghi variano in base alla libreria scelta in region. L'accesso alla riproduzione non è garantito.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su iqiyi e action impostato su album. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint iQIYI Album di EveryInfra (iqiyi/album).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su iqiyi e action su album, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: Specifica i termini di ricerca per l'azione search oppure i nomi di serie, album e membri del cast per l'azione album internazionale.
- Parametri facoltativi:
- lang: Imposta la lingua di visualizzazione dei titoli per l'azione album con codici compatti: zhcn, zhtw, enus, jajp, arsa, eses, idid, kokr, msmy, thth o vivn. (valori consentiti: arsa / enus / eses / idid / jajp / kokr / msmy / thth)
- language: Accetta un codice lingua di compatibilità per la localizzazione dei titoli nell'azione album: zh_cn (predefinito), zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es o ar_sa. (valori consentiti: ar_sa / en_us / es_es / id_id / ja_jp / ko_kr / ms_my / th_th)
- region: Seleziona la regione del catalogo per l'azione album: intl (predefinito), vn, th, id, my, tw, ph, sg, kr o jp. Qualsiasi altro valore restituisce 422. (valori consentiti: id / intl / jp / kr / my / ph / sg / th)
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 10)
- Restituisce un elenco di record. Campi principali di ogni record: id, url, play_url, title, subtitle, type, is_series, year, release_date, duration_seconds, duration_sec, rating; 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=iqiyi.
- Esempio di corpo della richiesta:
{
"platform": "iqiyi",
"action": "album",
"params": {
"keyword": "电影"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | iqiyi | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | album | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | Specifica i termini di ricerca per l'azione search oppure i nomi di serie, album e membri del cast per l'azione album internazionale. L'azione album non recupera i dettagli direttamente dagli URL degli album e i cataloghi disponibili variano in base alla regione. |
lang | body.params | string (enum) | No | - | Imposta la lingua di visualizzazione dei titoli per l'azione album con codici compatti: zhcn, zhtw, enus, jajp, arsa, eses, idid, kokr, msmy, thth o vivn. Questo parametro modifica le etichette dei metadati localizzati senza richiedere sottotitoli né cambiare la regione del catalogo.Valori consentitiarsaenusesesididjajpkokrmsmyththvivnzhcnzhtw |
language | body.params | string (enum) | No | - | Accetta un codice lingua di compatibilità per la localizzazione dei titoli nell'azione album: zh_cn (predefinito), zh_tw, en_us, id_id, ms_my, th_th, vi_vn, ko_kr, ja_jp, es_es o ar_sa. Se fornisci sia questo parametro sia lang, lang ha la priorità; non mescolare i formati dei codici tra i due parametri.Valori consentitiar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw |
region | body.params | string (enum) | No | - | Seleziona la regione del catalogo per l'azione album: intl (predefinito), vn, th, id, my, tw, ph, sg, kr o jp. Qualsiasi altro valore restituisce 422. Questo parametro cambia il catalogo regionale, non la lingua dell'interfaccia.Valori consentitiidintljpkrmyphsgthtwvn |
limit | body.params | integer (1–50) | No | 10 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 50. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
Esempi di codice
#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": "电影"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#Acquisita il September 26, 2026 at 08:56 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
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": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
url | Link al record sulla piattaforma. |
play_url | Mantiene il significato attribuito dalla piattaforma |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
subtitle | Mantiene il significato attribuito dalla piattaforma |
type | Tipo di record; i valori dipendono dalla funzionalità (ad esempio video / image / text). |
is_series | Mantiene il significato attribuito dalla piattaforma |
year | Mantiene il significato attribuito dalla piattaforma |
release_date | Mantiene il significato attribuito dalla piattaforma |
duration_seconds | Durata in secondi. null per i contenuti che non sono video o audio. |
duration_sec | Mantiene il significato attribuito dalla piattaforma |
rating | Valutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito. |
rating_scale | Valore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione. |
content_rating | Mantiene il significato attribuito dalla piattaforma |
episode_count | Mantiene il significato attribuito dalla piattaforma |
episode_available_count | Mantiene il significato attribuito dalla piattaforma |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
episodes | Mantiene il significato attribuito dalla piattaforma |
cast | Mantiene il significato attribuito dalla piattaforma |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- iQIYI International: restrizioni regionali sul copyright e catalogo attivo ↗
Le FAQ di assistenza di iQIYI International sulle restrizioni di copyright spiegano che le licenze regionali possono impedire la riproduzione dei contenuti e che i risultati di ricerca esterni possono non riflettere il catalogo attivo. Le opzioni di regione di album e i metadati recuperati quindi non garantiscono il diritto alla riproduzione, e tanto meno offrono un modo per aggirare le restrizioni regionali.
Verificato il 2026-09-04