Rednote User Profile
I profili pubblici di Rednote possono esporre un identificatore dell’account, l’handle Rednote, il nome visualizzato, la biografia, le immagini del profilo, il sito web, i flag dell’account e i conteggi visibili di follower, seguiti e post. Un record normalizzato riunisce questi campi di identità disponibili e i segnali puntuali per l’abbinamento degli account, il confronto tra profili selezionati e l’analisi di istantanee ripetute.
Funzionalità della Rednote User Profile API
- Due percorsi di ricerca con priorità esplicitaRisolve un profilo da un URL Rednote supportato o da uno user_id pubblico. Se vengono forniti entrambi i campi, per la ricerca alla fonte si usa user_id esplicito.
- Record di identità pubblica coerenteNormalizza ID dell’account, URL della fonte, handle Rednote, nome visualizzato, biografia, avatar, immagine di copertina, sito web, flag di verifica e flag di privacy, quando disponibili.
- Segnali visibili dell’account con timestampRestituisce i conteggi disponibili di follower, seguiti e post accanto a collected_at, così ogni risultato resta un’osservazione puntuale e non un totale in tempo reale.
Parametri della Rednote User Profile API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio (almeno uno) | È obbligatorio uno tra url e user_id. L’hostname analizzato deve essere xiaohongshu.com, xhslink.com o un sottodominio di uno dei due host. Se è presente anche user_id, user_id ha la priorità. |
user_id | Obbligatorio (almeno uno) | È obbligatorio uno tra user_id e url. Usa da 1 a 256 lettere ASCII, numeri, due punti, trattini bassi o trattini. Questo identificatore esplicito ha la priorità quando viene fornito anche url. |
Come usare la Rednote User Profile API
Invia un riferimento a un account supportato, segui l’attività asincrona e leggi l’account normalizzato dalla pagina dei risultati salvati.
- Prepara uno user_id pubblico attuale o un URL il cui hostname analizzato sia xiaohongshu.com, xhslink.com o un sottodominio di uno dei due host.
- Invia user_id, url o entrambi a /v1/rednote/user-profile; quando sono presenti entrambi, user_id ha la priorità. Salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
- Leggi l’account in data.results.items. Usa next_cursor solo se il lettore dei risultati salvati indica has_more come true.
REDNOTE_USER_ID=''
# Paste a current public Rednote account identifier before running.
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"$REDNOTE_USER_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueCasi d’uso della Rednote User Profile API
- Arricchimento di account noti: Trasforma un riferimento esistente a un account Rednote pubblico in un record di identità coerente, con testo del profilo, immagini, sito web e flag dell’account disponibili.
- Confronto di istantanee dei profili: Confronta account selezionati o raccolte ripetute usando ID dei risultati stabili, collected_at e i conteggi di follower, seguiti e post disponibili al momento della raccolta.
Consigli degli esperti per la Rednote User Profile API
- Fornisci almeno un input. Quando sono presenti sia url sia user_id, il backend usa user_id esplicito e non invia l’URL alla ricerca alla fonte.
- Preferisci user_id quando hai già l’identificatore pubblico dell’account; così non dipendi dalla struttura di un URL condiviso o dell’account.
- Convalida user_id con ^[A-Za-z0-9:_-]{1,256}$ e richiedi che l’hostname analizzato dell’URL corrisponda a xiaohongshu.com, xhslink.com o a un sottodominio prima dell’invio.
- Non aggiungere results_limit né un cursore della fonte. Questo endpoint fa una sola richiesta di dettaglio, mentre next_cursor appartiene solo al lettore dei risultati salvati di SocQ.
- Considera biografia, immagini del profilo, sito web, flag e ogni metrica come facoltativi. Conserva i null invece di convertire i campi mancanti in stringhe vuote o zero.
- Un risultato precedente di un account Rednote può fornire il proprio id canonico per user_id. Tieni questo identificatore distinto dallo username restituito, che rappresenta l’handle Rednote disponibile.
API correlate
Oltre alla Rednote User Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.