rednote/
note-detail

Recupera una nota pubblica di Rednote da un URL xiaohongshu.com o xhslink.com con token, con testo, autore, media, timestamp ed engagement visibile normalizzati.

Rednote Note Detail API

URL della nota con token
Dettaglio di una singola nota
Record di post normalizzato
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 Note Detail

Le note di Rednote sono contenuti pubblici che abbinano testo e media a identità dell’autore, riferimenti ai temi, data di pubblicazione ed engagement visibile. Questi campi supportano l’arricchimento di link già noti, la revisione dei contenuti e il confronto puntuale di note selezionate.

Funzionalità della Rednote Note Detail API

  • Ricerca della nota con tokenRisolve un URL di nota pubblica già noto solo quando host accettato, percorso di dettaglio della nota e xsec_token non vuoto identificano una ricerca completa alla fonte.
  • Contesto di nota e autoreRestituisce identità normalizzata della nota, URL della fonte, testo, timestamp e, se disponibili, ID dell’autore, nome utente, nome visualizzato, URL del profilo, avatar e flag dell’account.
  • Istantanea di media ed engagementConserva con il momento della raccolta i riferimenti ai media disponibili, le anteprime, le dimensioni, la durata, i riferimenti ai temi e i conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni.

Parametri della Rednote Note Detail API

ParametriObbligatorioDescrizione
urlObbligatorioURL obbligatorio non vuoto su xiaohongshu.com, xhslink.com o un sottodominio. Il percorso deve includere /explore/{note_id} oppure /discovery/item/{note_id} e la query deve contenere un xsec_token non vuoto.

Come usare la Rednote Note Detail API

Fornisci un URL di nota attuale con token, invia la richiesta asincrona e leggi il singolo record di post normalizzato al termine.

  1. Copia un URL di nota pubblica attuale il cui host accettato, percorso di dettaglio della nota e query string includano un xsec_token non vuoto.
  2. Invia con POST l’url a /v1/rednote/note-detail e salva data.task_id dalla risposta di invio.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. Leggi data.results.items dopo il successo. La ricerca alla fonte è una singola richiesta di dettaglio; next_cursor scorre solo i record salvati da SocQ.
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes

curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_NOTE_URL\"}"

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

Casi d’uso della Rednote Note Detail API

  • Arricchire un catalogo di note già note: Trasforma un URL di nota valido in identità, testo, autore, data di pubblicazione e campi della fonte normalizzati per un indice di contenuti esistente.
  • Rivedere il contenuto di note selezionate: Usa testo, contesto dell’autore, riferimenti ai media e campi dei temi per esaminare un insieme definito di singole note pubbliche.
  • Confrontare le osservazioni di engagement: Abbina i conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni a collected_at in ricerche inviate separatamente per un confronto puntuale.

Consigli degli esperti per la Rednote Note Detail API

  • Usa l’URL completo della nota, con host, percorso /explore/ o /discovery/item/ e parametro di query xsec_token; un semplice ID della nota non supera la validazione.
  • Tieni xsec_token dentro la query dell’URL, perché la richiesta accetta solo url e rifiuta un campo token separato.
  • Se riutilizzi un URL da un altro risultato Rednote di SocQ, verifica che xsec_token sia ancora presente; Note Detail non può ricostruire un token mancante.
  • Invia un URL per attività, perché questo endpoint di dettaglio non ha un campo batch, results_limit né un cursore della fonte.
  • Considera next_cursor solo come paginazione dei risultati salvati; la fonte esegue una sola ricerca di dettaglio e di norma produce al massimo un record.
  • Salva in modo difensivo i campi di autore, media, temi, timestamp ed engagement e abbina i contatori visibili a collected_at, perché i valori pubblici facoltativi possono mancare.

Esplora altre piattaforme

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

Rednote Note Detail API — FAQ

Rednote Note Detail API recupera una nota pubblica di Rednote da un URL con token su un host accettato, restituendo identità normalizzata della nota, testo, autore, media, riferimenti ai temi, timestamp e campi di engagement visibili.

Usa un URL non vuoto su xiaohongshu.com, xhslink.com o un sottodominio. Il percorso deve contenere /explore/{note_id} oppure /discovery/item/{note_id} e la query deve includere un xsec_token non vuoto.

No. Lo schema pubblico della richiesta accetta solo url; SocQ estrae note_id e xsec_token da quell’URL.

Invia un URL di nota pubblica attuale che includa già xsec_token. Un URL restituito da un altro endpoint di note Rednote di SocQ è riutilizzabile solo se quel parametro di query è ancora presente; Note Detail non crea un token mancante.

Il record di post normalizzato può includere identità della nota, URL, testo, date di pubblicazione e raccolta, dati dell’autore, media, hashtag, menzioni e conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni. I campi pubblici facoltativi possono essere null.

No. La fonte esegue una sola ricerca di dettaglio e salva al massimo un record. Il lettore condiviso delle attività espone comunque limit, next_cursor e has_more per i record salvati da SocQ.

L’endpoint è configurato a un costo fisso di 1,00 crediti SocQ per attività. La stima non cambia con il numero di record restituiti.