API iQIYI Ricerca
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
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.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su iqiyi e action impostato su search. 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.
iQIYI Search trova video su iQIYI in base a keyword e restituisce per ogni risultato titolo, descrizione, categoria, durata, indice di popolarità, valutazione, like, commenti e salvataggi, oltre alla serie di appartenenza, ai poster, al cast e ai dati di chi ha caricato il video. Usala per vedere quali film, serie, show e clip esistono per un titolo o un tema e come vengono accolti, per ricerche sulle licenze dei contenuti, studi di mercato sull'intrattenimento o per monitorare uno show su iQIYI.
Restringi i risultati con category, ad esempio movie, tv_series o variety_shows, imposta un intervallo temporale con publish_date e l'ordinamento con sort. iQIYI chiama album una serie e video ogni episodio, per questo i campi della serie iniziano con album. heat_count è l'indice di popolarità di iQIYI, non un numero di visualizzazioni, e non è confrontabile tra piattaforme. rating è espresso su 10: controlla rating_scale nella riga prima di confrontarlo con siti che usano le cinque stelle.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint iQIYI Ricerca di EveryInfra (iqiyi/search).
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 search, 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:
- category: 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, mo… (valori consentiti: advertisement / all / animation / beauty / car / comedy / documentary / entertainment)
- publish_date: Filtra i risultati dell'azione search per periodo di pubblicazione e accetta all, last_24_hours, last_7_days o last_30_days.
- published: 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.
- quality: 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.
- scrape_additional_info: 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.
- site: 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.
- sort: Controlla l'ordinamento dei risultati della ricerca video e accetta relevance, newest o popular. (valori consentiti: newest / popular / relevance)
- 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: 20)
- Restituisce un elenco di record. Campi principali di ogni record: id, url, title, text, category, category_id, duration_seconds, duration_sec, heat_count, rating, rating_scale, rating_count; 30 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=iqiyi.
- Esempio di corpo della richiesta:
{
"platform": "iqiyi",
"action": "search",
"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ì | search | 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. |
category | body.params | string (enum) | No | - | 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 consentitiadvertisementallanimationbeautycarcomedydocumentaryentertainmentfashionfinancegamehealthlifemilitarymother_babymoviemusicnews_infooriginalsshort_filmssportssquare_dancetalk_showstechnologytrailerstraveltrendingtv_seriesvariety_shows |
publish_date | body.params | string | No | - | 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à. |
published | body.params | string | No | - | 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. |
quality | body.params | string | No | - | 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_info | body.params | boolean | No | - | 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. |
site | body.params | string | No | - | 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. |
sort | body.params | string (enum) | No | - | 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 consentitinewestpopularrelevance |
limit | body.params | integer (1–50) | No | 20 | 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
#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": "search",
"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
#{ "id": "req_…", "platform": "iqiyi", "action": "search", "results": [ { "id": "•••", "url": "https://qy.net/63KmTun-1f", "title": "大黄蜂捕食蜜蜂，实力碾压 #好奇昆虫 #动物世界 #纪录片", "category": "纪录片", "category_id": 3, "duration_seconds": 82, "heat_count": 123, "like_count": 0, "comment_count": 0, "collect_count": 0, "image_url": "https://m.iqiyipic.com/u1/image/20261024/cb/27/pv_8409605938704600_d_601_m1_120_160.jpg", "wide_image_url": "https://m.iqiyipic.com/u1/image/20261024/cb/27/pv_8409605938704600_d_601_m1_480_270.jpg", "author_name": "•••", "author_id": "•••", "author_avatar_url": "https://img7.iqiyipic.com/•••", "author_follower_count": 529, "author_video_count": 52, "author_location": "河南", "author_org": "漯河市郾城区芝芝文化传媒工作室（个体工商户）", "posted_at": "2026-10-24T15:30:00+00:00", "platform": "iqiyi", "duration_sec": 82 }, { "id": "•••", "url": "https://qy.net/f6KjGub-7c", "title": "听说过日本姓氏奇葩，没想到这么奇葩 #搞笑 #大型纪录片 ", "category": "搞笑", "category_id": 22, "duration_seconds": 98, "heat_count": 7, "like_count": 0, "comment_count": 0, "collect_count": 0, "image_url": "https://m.iqiyipic.com/u1/image/20261024/64/15/pv_1225408606708600_d_601_m1_120_160.jpg", "wide_image_url": "https://m.iqiyipic.com/u1/image/20261024/64/15/pv_1225408606708600_d_601_m1_480_270.jpg", "author_name": "•••", "author_id": "•••", "author_avatar_url": "https://img7.iqiyipic.com/•••", "author_follower_count": 217, "author_video_count": 156, "author_location": "河南", "author_org": "漯河市郾城区芝芝文化传媒工作室（个体工商户）", "posted_at": "2026-10-24T10:40:00+00:00", "platform": "iqiyi", "duration_sec": 98 } ], "count": 20, "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. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
category | Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme. |
category_id | 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 |
heat_count | 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. |
rating_count | Numero di persone che hanno espresso una valutazione. null significa non reso noto, non 0. |
like_count | Like. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0. |
comment_count | Commenti. null significa non resi noti, non 0. |
collect_count | Salvataggi o preferiti. null significa non resi noti, non 0. |
album_id | Mantiene il significato attribuito dalla piattaforma |
album_title | Mantiene il significato attribuito dalla piattaforma |
album_url | Mantiene il significato attribuito dalla piattaforma |
album_episode_count | Mantiene il significato attribuito dalla piattaforma |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
wide_image_url | Mantiene il significato attribuito dalla piattaforma |
author_name | Nome visualizzato dell'autore. |
author_id | ID univoco dell'autore sulla piattaforma. |
author_avatar_url | Mantiene il significato attribuito dalla piattaforma |
author_follower_count | Numero di follower dell'autore. null significa non reso noto. |
author_video_count | Mantiene il significato attribuito dalla piattaforma |
author_location | Mantiene il significato attribuito dalla piattaforma |
author_org | Mantiene il significato attribuito dalla piattaforma |
posted_at | Data e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
cast | Mantiene il significato attribuito dalla piattaforma |
FAQ
#heat_count è il numero di visualizzazioni?
#No. È l'indice di popolarità di iQIYI, una metrica della piattaforma e non un conteggio delle riproduzioni, quindi non può essere confrontato con i dati di altre piattaforme. Usalo per ordinare i risultati all'interno di iQIYI e leggilo insieme a rating e rating_count quando valuti l'accoglienza di un titolo.
Come mantengo solo film o serie TV?
#Imposta category su movie o tv_series; variety_shows, animation e documentary funzionano allo stesso modo, mentre all rimuove il filtro. category è un tipo di contenuto, non un tag di cast o di serie. Per i caricamenti recenti, imposta published o publish_date su un intervallo come last_7_days. Se li invii entrambi prevale published, e nessuno dei due accetta una data di calendario.
Come raggruppo gli episodi della stessa serie?
#iQIYI archivia ogni episodio come video all'interno di una serie, che chiama album. Le righe di una stessa serie condividono album_id e album_title, album_episode_count indica il numero totale di episodi della serie e album_url rimanda alla pagina della serie, così puoi aggregare i dati degli episodi a livello di show.
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: 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 il 2026-09-04