API Douyin Panoramica dell'account

Temporaneamente non disponibile

Stiamo ripristinando questa funzionalità. Nel frattempo le chiamate di solito non vanno a buon fine o non restituiscono risultati; le chiamate non riuscite e i risultati vuoti non vengono addebitati.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Temporaneamente non disponibile
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Temporaneamente non disponibile

Ultime 24 ore

Ultimi 30 giorni

Ottieni un quadro rapido di un account Douyin a partire dal suo secUid in user_id (una stringa MS4w) o da un link https://www.douyin.com/user/<secUid>; nickname, Douyin ID e short link non sono accettati. Ottieni un solo oggetto: i campi del profilo (nickname, Douyin ID, bio, numero di follower, account seguiti, like e video, verifica, avatar) e le statistiche sui post recenti dell'account: recent_post_count (circa 20, post fissati inclusi), recent_media_types, recent_stats (media, mediana e massimo di like, commenti, condivisioni e salvataggi), posts_per_week, newest_post_at, oldest_post_at, top_posts per like e gli stessi recent_posts. Le statistiche coprono i post della prima pagina del profilo, quindi i post degli ultimi 7 giorni circa non sono inclusi; newest_post_at indica il post più recente coperto.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douyin e action impostato su user_overview. Prezzo $1.6 per 1.000 richieste ($0.001597 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 Douyin Panoramica dell'account di EveryInfra (douyin/user_overview).

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 douyin e action su user_overview, e inserisci i parametri in params.
- Parametri obbligatori:
  - user_id: L'account da riassumere: il suo secUid (che inizia con MS4w) o un link del profilo https://www.douyin.com/user/<secUid>. Nickname, Douyin ID e short link non sono accettati.
- Restituisce un oggetto. Campi principali: user_id, douyin_id (Douyin ID: l'ID ricercabile scelto dal…), nickname (Nome visualizzato dell'account), bio, url, follower_count, following_count, like_count, video_count (Numero di video: i video dell'account i…), is_verified, avatar_url, recent_post_count (Quanti post recenti vengono usati per l…); 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Esempio di corpo della richiesta:
{
  "platform": "douyin",
  "action": "user_overview",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}
- Prezzo: $1.6 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

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìdouyinIdentificativo della piattaforma, valore fisso.
actionbodystringSìuser_overviewIdentificativo della funzionalità, valore fisso.
user_idbody.paramsstringSì-L'account da riassumere: il suo secUid (che inizia con MS4w) o un link del profilo https://www.douyin.com/user/<secUid>. Nickname, Douyin ID e short link non sono accettati.

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": "douyin",
  "action": "user_overview",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}'

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

#
Non è ancora disponibile una risposta di esempio per questi parametri. Questa anteprima mostra la struttura e i campi della risposta secondo la definizione dell'API, con … come segnaposto; non è il risultato di una chiamata reale.
json
{  "id": "req_…",  "platform": "douyin",  "action": "user_overview",  "results": {    "user_id": …,    "douyin_id": …,    "nickname": …,    "bio": …,    "url": …,    "follower_count": …,    "following_count": …,    "like_count": …,    "video_count": …,    "is_verified": …,    "avatar_url": …,    "platform": …,    "recent_post_count": …,    "recent_media_types": …,    "recent_stats": …,    "posts_per_week": …,    "newest_post_at": …,    "oldest_post_at": …,    "top_posts": …,    "recent_posts": …  },  "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.

CampoSignificato
user_idID univoco dell'utente sulla piattaforma.
douyin_idDouyin ID: l'ID ricercabile scelto dal titolare dell'account.
nicknameNome visualizzato dell'account.
bioBio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji.
urlLink al record sulla piattaforma.
follower_countFollower. null significa non reso noto, non 0.
following_countAccount seguiti. null significa non reso noto, non 0.
like_countLike. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0.
video_countNumero di video: i video dell'account in profile, profiles_batch, user_overview e billboard_account_search, i video correlati alla voce in trending.
is_verifiedIndica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo.
avatar_urlLink all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
recent_post_countQuanti post recenti vengono usati per le statistiche (user_overview), circa 20, post fissati inclusi.
recent_media_typesNumero di post recenti per tipo (user_overview), ad esempio {"video": 22}.
recent_statsEngagement dei post recenti (user_overview): like_count, comment_count, share_count e collect_count, ciascuno come {avg (media), median, max}.
posts_per_weekNumero medio di post a settimana nel campione recente (user_overview).
newest_post_atData di pubblicazione del post più recente del campione (user_overview, ISO 8601, UTC); i post degli ultimi 7 giorni circa non fanno parte del campione.
oldest_post_atData di pubblicazione del post meno recente del campione (user_overview, ISO 8601, UTC).
top_postsI post recenti con più Mi piace (user_overview): [{id, title, like_count, url}].
recent_postsI post recenti (user_overview); ognuno ha gli stessi campi di una riga di user_posts.

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

Google Analytics: serve il consenso Privacy