douyin/
user-profile

Recupera un profilo pubblico di Douyin da un URL di profilo supportato o da un identificatore utente, con identità normalizzata, biografia, immagini, flag dell’account e conteggi visibili.

Douyin User Profile API

URL o ID utente
Un solo profilo pubblico
Campi dell’account normalizzati
0,1 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Douyin User Profile

I profili utente di Douyin sono superfici pubbliche di account con identità, biografia, immagini del profilo, segnali di verifica e privacy, oltre ai conteggi visibili di follower, seguiti e post. Questi campi supportano l’arricchimento degli account, i controlli di identità, il monitoraggio delle istantanee e la ricerca comparativa sui profili.

Funzionalità della Douyin User Profile API

  • Due identificatori supportatiRisolvi un profilo pubblico da un URL utente di Douyin supportato oppure da uno user_id conforme alla regola degli identificatori del runtime.
  • Identità e presentazione del profiloRestituisce ID del profilo, URL pubblico, nome utente, nome visualizzato, biografia, avatar, immagine di copertina e sito web associato, quando disponibili, in un unico record di account.
  • Campi espliciti sullo stato dell’accountConserva i flag disponibili di verifica e privacy come valori nullable, invece di dedurre uno stato quando la fonte pubblica lo omette.
  • Misure visibili del profiloNormalizza i conteggi disponibili di follower, seguiti e post insieme a collected_at, per una vista del profilo pubblico riferita a un preciso momento.

Parametri della Douyin User Profile API

ParametriObbligatorioDescrizione
urlObbligatorio (almeno uno)Fornisci url o user_id. Un URL non vuoto deve usare douyin.com, iesdouyin.com o un sottodominio e includere un percorso /user/<identifier>.
user_idObbligatorio (almeno uno)Fornisci user_id o url. user_id accetta da 1 a 256 lettere ASCII, numeri, due punti, trattini bassi o trattini e ha la precedenza se vengono inviati entrambi i campi.

Come usare la Douyin User Profile API

Invia un identificatore di profilo supportato, segui l’attività asincrona e leggi l’account normalizzato dall’envelope dei risultati salvati.

  1. Prepara un URL completo di profilo Douyin con un percorso /user/<identifier> oppure uno user_id pubblico supportato.
  2. Invia con POST un identificatore a /v1/douyin/user-profile e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  4. Dopo il successo leggi data.results.items; la ricerca alla fonte produce al massimo un profilo, mentre l’envelope dei risultati salvati riporta comunque has_more e next_cursor.
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.items

Casi d’uso della Douyin User Profile API

  • Arricchimento dei record dei creator: Aggiungi identità, biografia, immagini, sito web, flag dell’account e conteggi pubblici di Douyin disponibili a un record di creator esistente.
  • Controlli sull’identità dei profili: Trasforma un URL di profilo o un identificatore utente noto in un oggetto account coerente prima di collegarlo a un’entità interna.
  • Confronti tra account pubblici: Confronta i conteggi di follower, seguiti e post tra profili raccolti separatamente, usando le stesse chiavi di metrica normalizzate.
  • Monitoraggio delle istantanee dei profili: Salva campi di identità e metriche pubbliche con collected_at, così le attività successive restano osservazioni distinguibili in momenti diversi.

Consigli degli esperti per la Douyin User Profile API

  • Quando hai già un identificatore utente canonico, invia solo user_id; se url e user_id non coincidono, la richiesta al provider usa user_id.
  • Prima di inviare un URL, verifica l’hostname e richiedi un percorso /user/<identifier>, così i link a video o ad altre risorse di Douyin vengono rifiutati in locale.
  • Aspettati zero o un record di profilo alla fonte; il cursore del lettore delle attività pagina gli elementi SocQ salvati e non può richiedere un’altra pagina al provider per questa ricerca.
  • Tratta identità, immagini, sito web, flag dell’account, località e ogni metrica come nullable e conserva collected_at quando confronti istantanee ripetute.

Oltre alla Douyin User Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Douyin.

Esplora altre piattaforme

Combina i dati di Douyin con i dati pubblici delle altre piattaforme social supportate.

Douyin User Profile API — FAQ

Douyin User Profile API recupera un account pubblico di Douyin da un URL di profilo supportato o da un identificatore utente, restituendo identità normalizzata, biografia, immagini, flag dell’account, conteggi visibili e orario di raccolta.

Uno qualsiasi dei due campi soddisfa il requisito della richiesta. Invia solo l’identificatore che vuoi risolvere, perché user_id ha la precedenza quando sono presenti entrambi i valori.

L’hostname analizzato deve essere douyin.com, iesdouyin.com o un sottodominio e il percorso deve contenere /user/ seguito da un identificatore composto da lettere, numeri, trattini bassi o trattini. I link ai video e gli host non pertinenti vengono rifiutati.

Lo schema dell’account può contenere ID e URL del profilo, nome utente, nome visualizzato, biografia, avatar, immagine di copertina, sito web, flag di verifica e privacy, località, numero di follower, numero di seguiti, numero di post e collected_at. I campi pubblici facoltativi restano null quando non è disponibile alcun valore.

No. La ricerca presso il provider è una richiesta di dettaglio singola che produce al massimo un profilo alla fonte; next_cursor e has_more descrivono solo la paginazione sui risultati già salvati da SocQ.

Ogni attività riuscita ha un costo fisso di 0,10 crediti SocQ. L’addebito non dipende da quanti campi facoltativi del profilo sono valorizzati.