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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL 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.
- 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.
- Invia con POST l’url a /v1/rednote/note-detail e salva data.task_id dalla risposta di invio.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
- 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.itemsCasi 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.
API correlate
Oltre alla Rednote Note Detail API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.