API Weibo Ricerca

Q: Come conto solo i post originali?

Filtra in base a is_repost: true indica che la riga è un repost, quindi escludila quando conti le menzioni originali. repost_count è il numero di volte in cui un post è stato ricondiviso, una misura di quanto si è diffuso.

Q: Come capisco se un autore è un grande account?

Controlla author_verified, poi leggi author_verified_reason, che indica il motivo della verifica, ad esempio un ruolo aziendale. Combina questi dati con author_follower_count per valutare la portata potenziale dei post dell'account.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: 100%
Tempo medio nelle ultime 24 ore: 7.20 s

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Trova i post di Weibo che citano una parola chiave, fino a 50 per chiamata. Ottieni testo, dispositivo di pubblicazione, numero di repost, commenti e like, e follower e verifica dell'autore. Usa is_repost per distinguere i repost dai post originali. La copertura completa di un periodo di tempo non è garantita.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su weibo e action impostato su search. Prezzo $0.81 per 1.000 richieste ($0.000806 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.

La funzionalità Weibo Search trova post pubblici in base a keyword e restituisce per ogni post testo, data di pubblicazione, dispositivo di pubblicazione, numero di repost, commenti e like e se è un repost, oltre a nickname, bio, numero di follower, stato di verifica e nota di verifica dell'autore, con i link a immagini e video. Usala per vedere chi parla di un argomento su Weibo, cosa dice e quanto si diffonde: monitoraggio dell'opinione pubblica, conteggio delle menzioni di un brand e individuazione dei key opinion leader.

Distingui i grandi account verificati con author_verified_reason, che indica per cosa è stata concessa la verifica, e valuta la portata con author_follower_count. Escludi i repost con is_repost quando conti le menzioni originali. La classifica dei contenuti di tendenza non richiede parole chiave; leggila con la funzionalità Weibo Trending.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Weibo Ricerca di EveryInfra (weibo/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 weibo e action su search, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Indica il termine di ricerca dei post pubblici nell'azione search. L'azione trending non usa un parametro keyword e restituisce gli argomenti più cercati del momento, non i post degli utenti.
- Parametri facoltativi:
  - 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, text, posted_at, device (Client da cui è stato pubblicato il pos…), repost_count, comment_count, like_count, is_repost (Indica se il post è una ricondivisione), author_id, author_name, author_bio (Bio dell'autore); 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=weibo.
- Esempio di corpo della richiesta:
{
  "platform": "weibo",
  "action": "search",
  "params": {
    "keyword": "城市骑行"
  }
}
- Prezzo: $0.81 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ì	`search`	Identificativo della funzionalità, valore fisso.
`keyword`	body.params	`string`	Sì	-	Indica il termine di ricerca dei post pubblici nell'azione search. L'azione trending non usa un parametro keyword e restituisce gli argomenti più cercati del momento, non i post degli utenti.
`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

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": "weibo",
  "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

json

{  "id": "req_…",  "platform": "weibo",  "action": "search",  "results": [    {      "id": "•••",      "url": "https://weibo.com/2590508284/5347470118748545",      "text": "【层林逐风  赛道如画｜2026环北京·门头沟国际公路自行车赛第二日激战正酣】9月26日，为期三天的2026环北京·门头沟国际公路自行车赛进入第二个比赛日。本届赛事为国际自行车联盟（UCI）认证的2.2级亚洲巡回赛事，共吸引来自11个国家和地区的21支队伍的百余名职业车手及约3000名自行车爱好者参与，职业组总赛程超过340公里。赛事历时三日，设斋堂耐力、京西山地、城市绕圈三大特色赛段；当日举行的第二赛段——京西山地赛段，是爬坡难度最高、参与人群覆盖面最广的赛段，设职业组、大众骑游39公里组与大众骑游9公里组三个组别。本届赛事是2026京西国际山地户外季…",      "posted_at": "Sat Sep 26 18:48:09 +0800 2026",      "device": "HUAWEI Mate 60 Pro",      "repost_count": 0,      "comment_count": 0,      "like_count": 1,      "is_repost": false,      "author_id": "•••",      "author_name": "•••",      "author_verified": true,      "author_avatar_url": "https://tvax3.sinaimg.cn/•••",      "image_urls": [        "https://wx2.sinaimg.cn/orj1080/9a6804fcly1ihh9kjk3d5j20zk0npk68.jpg",        "https://wx2.sinaimg.cn/orj1080/9a6804fcly1ihh9kjj04hj20nl0fq7b6.jpg",        "https://wx3.sinaimg.cn/orj1080/9a6804fcly1ihh9kjp5dwj20tw13wqis.jpg"      ],      "platform": "weibo"    },    {      "id": "•••",      "url": "https://weibo.com/3075210951/5347460012838223",      "text": "#九九骑行节# #九号城市主理人#",      "posted_at": "Sat Sep 26 18:08:01 +0800 2026",      "device": "iPhone客户端",      "repost_count": 0,      "comment_count": 0,      "like_count": 0,      "is_repost": true,      "author_id": "•••",      "author_name": "•••",      "author_verified": false,      "author_avatar_url": "https://tvax1.sinaimg.cn/•••",      "video_url": "http://f.video.weibocdn.com/o0/gFJZA5WElx08AYxj2Opi01041201pS5N0E010.mp4?label=mp4_720p&template=1280x720.25.0&ori=0&ps=1CwnkDw1GXwCQx&Expires=1790423648&ssig=S036CI1rO4&KID=unistore,video",      "platform": "weibo"    }  ],  "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.
`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.
`device`	Client da cui è stato pubblicato il post (ad esempio un client per iPhone).
`repost_count`	Repost (distinti dai post con citazione). null significa non resi noti.
`comment_count`	Commenti. null significa non resi noti, non 0.
`like_count`	Like. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0.
`is_repost`	Indica se il post è una ricondivisione.
`author_id`	ID univoco dell'autore sulla piattaforma.
`author_name`	Nome visualizzato dell'autore.
`author_bio`	Bio dell'autore.
`author_follower_count`	Numero di follower dell'autore. null significa non reso noto.
`author_following_count`	Numero di account seguiti dall'autore.
`author_verified`	Indica se l'autore ha la verifica di Weibo (il badge V).
`author_verified_reason`	Descrizione della verifica (ad esempio un ruolo aziendale); usala per capire cosa rappresenta un account verificato.
`author_avatar_url`	URL dell'avatar dell'autore.
`image_urls`	Array di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini.
`video_url`	Link al video del post.
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Come conto solo i post originali?

Filtra in base a is_repost: true indica che la riga è un repost, quindi escludila quando conti le menzioni originali. repost_count è il numero di volte in cui un post è stato ricondiviso, una misura di quanto si è diffuso.

Come capisco se un autore è un grande account?

Controlla author_verified, poi leggi author_verified_reason, che indica il motivo della verifica, ad esempio un ruolo aziendale. Combina questi dati con author_follower_count per valutare la portata potenziale dei post dell'account.

Posso ottenere la classifica dei contenuti di tendenza?

La ricerca restituisce i post che contengono la tua parola chiave. La classifica dei contenuti di tendenza non richiede parole chiave: leggila con la funzionalità Weibo Trending, che restituisce voci di tendenza anziché post.

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.

Errori