API Weibo Dettagli del video
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
Ultime 24 ore
Ultimi 30 giorni
Apri un singolo post video di Weibo da un link al post, un ID numerico del post, un link al video o un ID video 1034: e ottieni il numero di riproduzioni, like, commenti e repost, la durata, la copertina e l'autore. Un link al video o un ID 1034: restituisce anche title, video_qualities e il numero di follower dell'autore; in tal caso i conteggi di riproduzioni e follower sono arrotondati. Gli URL dei video scadono; invia Referer: https://weibo.com/ quando li scarichi.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su weibo e action impostato su video. Prezzo $0.79 per 1.000 richieste ($0.000792 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 Weibo Dettagli del video di EveryInfra (weibo/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 weibo e action su video, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Un post video: un link al post (https://m.weibo.cn/detail/<ID> o https://weibo.com/<UID>/<ID or letter code>), un ID numerico del post, un link al video (https://weibo.com/tv/show/1034:<number>) o un ID video che inizia…
- Restituisce un oggetto. Campi principali: id, url, video_id (ID del video (video, collection_videos)), text, posted_at, play_count (Numero di riproduzioni di un video (vid…), like_count, comment_count, repost_count, duration_sec (Durata del video in secondi (post video…), duration_seconds, video_url (Link al video del post); 21 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=weibo.
- Esempio di corpo della richiesta:
{
"platform": "weibo",
"action": "video",
"params": {
"url": "https://weibo.com/1659899634/5326504200510190"
}
}
- Prezzo: $0.79 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ì | weibo | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | video | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | Un post video: un link al post (https://m.weibo.cn/detail/<ID> o https://weibo.com/<UID>/<ID or letter code>), un ID numerico del post, un link al video (https://weibo.com/tv/show/1034:<number>) o un ID video che inizia con 1034:. Un formato non riconosciuto restituisce 422 e non viene addebitato. |
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": "weibo",
"action": "video",
"params": {
"url": "https://weibo.com/1659899634/5326504200510190"
}
}'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": "weibo", "action": "video", "results": { "id": …, "url": …, "video_id": …, "text": …, "posted_at": …, "play_count": …, "like_count": …, "comment_count": …, "repost_count": …, "duration_sec": …, "duration_seconds": …, "video_url": …, "cover_image_url": …, "hashtags": …, "author_id": …, "author_name": …, "author_verified": …, "author_avatar_url": …, "platform": …, "title": …, "video_qualities": …, "author_follower_count": … }, "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. |
video_id | ID del video (video, collection_videos). |
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). |
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. |
play_count | Numero di riproduzioni di un video (video, collection_videos). Esatto in collection_videos e in video quando cerchi il post tramite link o ID del post; approssimativo in video quando usi un link al video o un ID 1034:, perché Weibo mostra un valore arrotondato. Non coincide con view_count, il numero di letture di un post. |
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. |
repost_count | Repost (distinti dai post con citazione). null significa non resi noti. |
duration_sec | Durata del video in secondi (post video su post_detail / user_posts, e video / collection_videos). |
duration_seconds | Durata in secondi. null per i contenuti che non sono video o audio. |
video_url | Link al video del post. |
cover_image_url | Mantiene il significato attribuito dalla piattaforma |
hashtags | Hashtag presenti nel testo, in ordine di apparizione; assente se non ce ne sono. |
author_id | ID univoco dell'autore sulla piattaforma. |
author_name | Nome visualizzato dell'autore. |
author_verified | Whether the author carries Weibo verification (the V badge). Not returned on some requests (search). |
author_avatar_url | Author avatar URL. Not returned on some requests (search). |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
title | Titolo; il significato dipende dall'azione. trending: il termine della ricerca di tendenza. topic_search: il nome dell'argomento. video: il titolo del video (solo quando url è un link al video o un ID 1034:). video_collections: il nome della raccolta. trending_boards: il nome della bacheca in cinese. |
video_qualities | URL dei video per qualità (video, solo quando url è un link al video o un ID 1034:): un array di {quality, url}, dove quality è il nome assegnato da Weibo (un'etichetta in cinese con la risoluzione, ad esempio 1080P) e video_url è il più nitido tra questi. Gli URL scadono, quindi chiama di nuovo per ottenerne di nuovi; invia Referer: https://weibo.com/ quando li scarichi. |
author_follower_count | Numero di follower dell'autore. Non restituito in alcune richieste (search, user_posts). In video arriva solo quando url è un link al video o un ID 1034:, ed è approssimativo. |
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.