rednote/
user-profile

Recupera un profilo pubblico di Rednote tramite URL dell’account supportato o user_id, con identità, immagini del profilo, flag dell’account, conteggi visibili e momento della raccolta normalizzati.

Rednote User Profile API

URL o user_id
Un account normalizzato
Attività a 1 credito fisso
1 credito 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

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

ParametriObbligatorioDescrizione
urlObbligatorio (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_idObbligatorio (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.

  1. 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.
  2. 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.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. 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 true

Casi 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.

Esplora altre piattaforme

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

Rednote User Profile API — FAQ

Rednote User Profile API recupera al massimo un profilo pubblico di Rednote da un URL di account supportato o da user_id e restituisce un record di account normalizzato.

Usa user_id quando lo conosci. Puoi inviare entrambi i campi, ma user_id esplicito ha la priorità e l’URL non viene inoltrato alla ricerca alla fonte.

Un URL deve avere come hostname analizzato xiaohongshu.com, xhslink.com o un sottodominio. user_id deve contenere da 1 a 256 lettere ASCII, numeri, due punti, trattini bassi o trattini.

Un risultato può includere ID, URL della fonte, handle Rednote, nome visualizzato, biografia, avatar, immagine di copertina, sito web, flag di verifica e privacy, conteggi di follower, seguiti e post, e momento della raccolta. I singoli campi possono essere null.

No. user_id è un identificatore di ricerca accettato e il risultato canonico ha un proprio id. username contiene l’handle Rednote quando la fonte lo fornisce, quindi chi chiama non dovrebbe sostituirlo a user_id senza verificare il valore della fonte.

No. Un’attività fa una sola richiesta di dettaglio del profilo e può salvare al massimo un account. La risposta comune dei risultati dell’attività include comunque items, next_cursor e has_more per leggere i record salvati da SocQ.

Ogni attività Rednote User Profile riuscita costa un credito SocQ fisso di 1,00. La richiesta non viene prezzata in base al numero di campi o di risultati salvati.