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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio (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_id | Obbligatorio (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.
- Prepara un URL completo di profilo Douyin con un percorso /user/<identifier> oppure uno user_id pubblico supportato.
- Invia con POST un identificatore a /v1/douyin/user-profile e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- 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.itemsCasi 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.
API correlate
Oltre alla Douyin User Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Douyin.
- Douyin Live Room Detail API — Recupera una diretta Douyin nota tramite l’ID numerico della stanza con contesto normalizzato della stanza, identità dell’host, media e conteggi visibili del pubblico.
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API