API Toutiao Commenti

POST

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

Leggi i commenti di primo livello di un articolo o video Toutiao, 20 per pagina. Ogni commento ha testo, like, numero di risposte, ora, nome, avatar, verifica e regione IP di chi commenta, e se l'autore ci ha messo like. Passa il link di un articolo o video o il suo ID numerico, e scorri le pagine con next_page_token. Le risposte non vengono restituite; reply_count indica quante sono.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su toutiao e action impostato su comments. 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.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Toutiao Commenti di EveryInfra (toutiao/comments).

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 toutiao e action su comments, e inserisci i parametri in params.
- Parametri obbligatori:
  - url: Un link a un articolo o a un video di Toutiao (https://www.toutiao.com/article/<ID>/ o https://www.toutiao.com/video/<ID>/; funzionano anche i vecchi link /i<ID>/, /a<ID>/ e /item/<ID>/) o l'ID numerico che contiene.
- Parametri facoltativi:
  - page_token: Token di pagina per comments: ripassa il next_page_token della risposta precedente per ottenere la pagina successiva; omettilo per partire dalla prima. Mantieni lo stesso url della chiamata che ha restituito il token.
- Restituisce un elenco di record. Campi principali di ogni record: id, text, like_count, reply_count, posted_at, author_id (Il token del profilo MS4w dell'autore (…), author_name, author_avatar_url (Link all'avatar di chi ha commentato (c…), author_verified (Indica se l'autore è verificato), author_auth_info (Descrizione della verifica, ad esempio…), ip_location (La regione IP di chi ha commentato come…), liked_by_author (Indica se l'autore dell'articolo o del…).
- Esempio di corpo della richiesta:
{
  "platform": "toutiao",
  "action": "comments",
  "params": {
    "url": "https://www.toutiao.com/article/7450114952884503059/"
  }
}
- 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ì	`toutiao`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`comments`	Identificativo della funzionalità, valore fisso.
`url`	body.params	`string`	Sì	-	Un link a un articolo o a un video di Toutiao (https://www.toutiao.com/article/<ID>/ o https://www.toutiao.com/video/<ID>/; funzionano anche i vecchi link /i<ID>/, /a<ID>/ e /item/<ID>/) o l'ID numerico che contiene. Ogni chiamata restituisce una pagina di massimo 20 commenti di primo livello.
`page_token`	body.params	`string`	No	-	Token di pagina per `comments`: ripassa il `next_page_token` della risposta precedente per ottenere la pagina successiva; omettilo per partire dalla prima. Mantieni lo stesso `url` della chiamata che ha restituito il token. I token durano 24 ore e ogni pagina corrisponde a una chiamata.

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": "toutiao",
  "action": "comments",
  "params": {
    "url": "https://www.toutiao.com/article/7450114952884503059/"
  }
}'

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": "toutiao",  "action": "comments",  "results": [    {      "id": "•••",      "text": "一箭四星，海上发射，谷神星一号海射型运载火箭成功升空，极大拓展了我国航天新一代运载火箭的能力，凸显了多轨道发射能力和一箭多星的快速发射优势。谷神星一号海射型运载火箭，是北京星河动力装备科技有限公司基于谷神星一号运载火箭为满足海上发射适应性而改进的产品。其海上成功发射不仅提高了安全性和可靠性，同时还带来了良好的经济性，科技国之利器，创新支撑中国商业航天“硬核“实力，中国商业航天与科技的实力与魅力，中国骄傲！",      "like_count": 0,      "reply_count": 0,      "posted_at": "2024-12-19T14:20:38+00:00",      "author_id": "•••",      "author_name": "上•••乡",      "author_avatar_url": "https://p11-sign.toutiaoimg.com/•••",      "author_verified": false,      "ip_location": "•••",      "liked_by_author": false,      "platform": "toutiao"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 1,  "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.
`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).
`like_count`	Like. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0.
`reply_count`	Risposte, di solito a un commento. null significa non rese note.
`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.
`author_id`	Il token del profilo MS4w dell'autore (video, solo video orizzontali); passalo come `user_id` a profile o user_posts.
`author_name`	Nome visualizzato dell'autore.
`author_avatar_url`	Link all'avatar di chi ha commentato (comments); su video, quello dell'autore.
`author_verified`	Indica se l'autore è verificato; su comments, chi ha commentato.
`author_auth_info`	Descrizione della verifica, ad esempio creator di un settore; su comments, quella di chi ha commentato, ad esempio un account ufficiale. Assente quando non c'è.
`ip_location`	La regione IP di chi ha commentato come la mostra Toutiao, di solito una provincia (comments).
`liked_by_author`	Indica se l'autore dell'articolo o del video ha messo Mi piace a questo commento (comments).
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

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