API Kuaishou Classifica delle persone più popolari

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 in una sola chiamata la classifica delle persone più popolari di Kuaishou, circa 50 account. Ogni account include posizione, nome, ID utente numerico, avatar, popolarità e il motivo dell'inserimento indicato da Kuaishou, ad esempio un nuovo video o un picco di ricerche. Passa un limit più basso per tenere solo i primi account.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su kuaishou e action impostato su hot_person_board. 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 Kuaishou Classifica delle persone più popolari di EveryInfra (kuaishou/hot_person_board).

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 kuaishou e action su hot_person_board, e inserisci i parametri in params.
- Nessun parametro obbligatorio.
- 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: 50)
- Restituisce un elenco di record. Campi principali di ogni record: rank (Posizione nella classifica dei contenut…), name (Nome della voce in classifica (azioni r…), type (Che cosa rappresenta la voce in classif…), user_id (ID utente numerico di Kuaishou (azioni…), avatar_url, reason (Perché l'account è in classifica, con l…), popularity (Popolarità mostrata nella classifica, c…).
- Esempio di corpo della richiesta:
{
  "platform": "kuaishou",
  "action": "hot_person_board",
  "params": {}
}
- 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ì	`kuaishou`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`hot_person_board`	Identificativo della funzionalità, valore fisso.
`limit`	body.params	`integer (1–50)`	No	`50`	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 superiori vengono accettati e limitati al valore massimo.

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": "kuaishou",
  "action": "hot_person_board",
  "params": {}
}'

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": "kuaishou",  "action": "hot_person_board",  "results": [    {      "rank": 1,      "name": "肖•••）",      "type": "user",      "user_id": "•••",      "avatar_url": "http://ty2.a.kwimgs.com/•••",      "reason": "作品更新",      "popularity": 13462082,      "platform": "kuaishou"    },    {      "rank": 2,      "name": "张•••🐑",      "type": "user",      "user_id": "•••",      "avatar_url": "http://ty2.a.kwimgs.com/•••",      "reason": "作品更新",      "popularity": 13081105,      "platform": "kuaishou"    }  ],  "count": 50,  "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
`rank`	Posizione nella classifica dei contenuti più popolari a partire da 1 (trending), nell'ordine di Kuaishou; la voce fissata è la prima.
`name`	Nome della voce in classifica (azioni rank): il nickname del conduttore o dell'account del brand, oppure il titolo del prodotto nelle righe di prodotto.
`type`	Che cosa rappresenta la voce in classifica (azioni rank): `user` per un account, `product` per un prodotto (solo nella classifica dei prodotti di shopping_rank).
`user_id`	ID utente numerico di Kuaishou (azioni rank, user_search, user_live); passalo a user_live.
`avatar_url`	Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
`reason`	Perché l'account è in classifica, con le parole di Kuaishou, ad esempio un nuovo video o un picco di ricerche (hot_person_board).
`popularity`	Popolarità mostrata nella classifica, come numero intero (un valore di 15,5 × 10.000 diventa 155000); confrontala solo all'interno della stessa classifica.
`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