API iQIYI Dettagli del video
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
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.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su iqiyi e action impostato su video. 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 Dettagli del video di EveryInfra (iqiyi/video).
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 video, e inserisci i parametri in params.
- Parametri obbligatori:
- url: 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.
- Parametri facoltativi:
- 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.
- Restituisce un oggetto. Campi principali: 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": "video",
"params": {
"url": "http://www.iqiyi.com/v_12vxqf0wkkw.html"
}
}
- 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ì | video | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | 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_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. |
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": "video",
"params": {
"url": "http://www.iqiyi.com/v_12vxqf0wkkw.html"
}
}'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": "video", "results": { "id": "•••", "url": "https://www.iqiyi.com/v_12vxqf0wkkw.html", "title": "风与潮第1集", "text": "《风与潮》首次将镜头聚焦于二战时期“孤岛”澳门波谲云诡的金融、贸易暗战,以爱国商人何贤、马万祺、中共地下党员柯麟兄弟等人物的传奇经历为原型,书写一代青年在颠沛中逆风而战,闯出一片生机的故事,致敬每一个在时代变局中坚守的中国人。", "category": "电视剧", "category_id": 2, "heat_count": 1514, "rating": 8.2, "rating_count": 59101, "like_count": 6044, "comment_count": 197613, "collect_count": 0, "album_id": "•••", "album_title": "风与潮", "album_url": "https://www.iqiyi.com/a_alcou1by21.html", "album_episode_count": 31, "image_url": "https://pic2.iqiyipic.com/image/20251204/ef/aa/a_100610350_m_601_m4_579_772.jpg", "wide_image_url": "https://pic2.iqiyipic.com/image/20251204/ef/aa/a_100610350_m_601_m4_480_270.jpg", "posted_at": "2026-09-14T12:36:00+00:00", "platform": "iqiyi", "cast": [ { "name": "任嘉伦", "role": "何贤" }, { "name": "蓝盈莹", "role": "乔音婉" }, { "name": "李纯", "role": "郭绮文" } ], "rating_scale": 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. |
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 |
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.