API di iQIYI
Cerca video su iQIYI e recupera episodi e cast degli album del sito internazionale tramite parole chiave e URL.
Cerca video per parola chiave. I punteggi di popolarità e il numero di visualizzazioni vengono tracciati separatamente dai contenuti.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su iqiyi e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 3 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di iQIYI: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca programmi e video su iQIYI per parola chiave, filtrando per categoria, periodo di pubblicazione, qualità, sito di origine o ordinamento, con durata, valore di popolarità, valutazione, serie e cast. | Normale | |
Dettagli del videovideo | Ottieni in JSON i dettagli di un video iQIYI da un url di riproduzione. | Normale | |
Albumalbum | Trova una serie o un film nel catalogo internazionale di iQIYI per titolo o nome di un membro del cast. | Normale |
Cosa accetta ogni azione di API di iQIYI?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca programmi e video su iQIYI per parola chiave, filtrando per categoria, periodo di pubblicazione, qualità, sito di origine o ordinamento, con durata, valore di popolarità, valutazione, serie e cast. | keyword | category, publish_date, published, quality, scrape_additional_info, site, sort | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | 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 | |
videoDettagli del video Ottieni in JSON i dettagli di un video iQIYI da un | url | scrape_additional_info | — | 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 | |
albumAlbum 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 | keyword | lang, language, region | Valori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | 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 |
Cosa significano i parametri search di API di iQIYI?
Cerca programmi e video su iQIYI per parola chiave, filtrando per categoria, periodo di pubblicazione, qualità, sito di origine o ordinamento, con durata, valore di popolarità, valutazione, serie e cast. heat_count è il punteggio di popolarità di iQIYI, non un numero di riproduzioni, e non è confrontabile tra piattaforme.
keywordObbligatorio- 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.iQIYI: differenza tra indice di popolarità dei contenuti e numero di riproduzioni sul sito — L'annuncio del 2018 di iQIYI descrive l'indice di popolarità dei contenuti come una metrica composita che comprende visualizzazioni, interazioni e condivisioni, distinta dal numero di riproduzioni. Questo spiega solo il tipo di metrica di heat_count: non si estende agli algoritmi o alle soglie attuali né alla comparabilità tra piattaforme, e non ricava il numero effettivo di riproduzioni dall'indice di popolarità. · Verificato
categoryFacoltativo- Filtra i video per categoria e accetta valori consentiti come 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 o all (nessuna restrizione). Questo parametro filtra macrocategorie, non tag di membri del cast o di serie.Valori ammessi:
advertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows publish_dateFacoltativo- Filtra i risultati dell'azione search per periodo di pubblicazione e accetta all, last_24_hours, last_7_days o last_30_days. Questo campo non accetta date YYYY-MM-DD e, se sono presenti sia questo campo sia published, published ha la priorità.
publishedFacoltativo- Sostituisce publish_date nell'azione search e accetta all, last_24_hours, last_7_days o last_30_days. Questo campo è un filtro di tipo stringa e non accetta valori booleani true/false.
qualityFacoltativo- Filtra i risultati di ricerca di iQIYI in base alla qualità video richiesta. Tra i valori comuni ci sono all, hd, ultra_hd, 720p e 1080p. Non è un'opzione di download o di transcodifica e i valori non elencati potrebbero non avere effetto.
scrape_additional_infoFacoltativo- Determina se i risultati di ricerca di iQIYI includono informazioni aggiuntive su chi ha caricato il video e sull'engagement. Passa un booleano JSON; il valore predefinito è true. Impostarlo su false disattiva questa ricerca aggiuntiva ma non cambia il prezzo dell'API EveryInfra.
siteFacoltativo- Fornisce una condizione sul sito di origine per search. Tra i valori comuni ci sono all, iqiyi, tencent_video, sohu, youku, tudou, acfun, bilibili, ifeng, cntv e m1905. Limita i risultati di ricerca a quei siti e non implica che ogni sito abbia un'azione di dettaglio.
sortFacoltativo- Controlla l'ordinamento dei risultati della ricerca video e accetta relevance, newest o popular. Non ordina per valutazione degli utenti né per ordine di uscita degli episodi, e non ha effetto quando richiedi un singolo video.Valori ammessi:
newestpopularrelevance
Cosa significano i parametri video di API di iQIYI?
Ottieni in JSON i dettagli di un video iQIYI da un url di riproduzione. Il record include titolo, categoria, durata, data di pubblicazione, valore di popolarità, valutazione, dettagli della serie, cast e autore del caricamento. Passa il link di riproduzione di un singolo video. Pagine delle serie e profili dei creator non sono supportati. Usa album per trovare una serie.
urlObbligatorio- Accetta l'URL completo di riproduzione di un video iQIYI (formato v_*.html) per l'azione video. Le pagine di serie/album (a_*.html) e i link ai profili dei creator non sono supportati; per trovare le serie usa l'azione album con keyword.
scrape_additional_infoFacoltativo- Determina se i risultati di ricerca di iQIYI includono informazioni aggiuntive su chi ha caricato il video e sull'engagement. Passa un booleano JSON; il valore predefinito è true. Impostarlo su false disattiva questa ricerca aggiuntiva ma non cambia il prezzo dell'API EveryInfra.
Cosa significano i parametri album di API di iQIYI?
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.
keywordObbligatorio- 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.
langFacoltativo- 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 ammessi:
arsaenusesesididjajpkokrmsmyththvivnzhcnzhtw languageFacoltativo- 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 ammessi:
ar_saen_uses_esid_idja_jpko_krms_myth_thvi_vnzh_cnzh_tw regionFacoltativo- 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 ammessi:
idintljpkrmyphsgthtwvniQIYI 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
Come usare l'API di iQIYI
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
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>"}}'
Domande sull'API di iQIYI
Cosa posso ottenere con l'API di iQIYI?
Imposta platform su iqiyi. Il catalogo attuale elenca ricerca, dettagli del video e album. Questi nomi di azione identificano oggetti o viste diversi di iQIYI; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di iQIYI?
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. Invialo come keyword all'interno di params.
Quali campi può restituire search di iQIYI?
Il suo schema dichiarato include title, text, category e category_id. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di iQIYI rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.