Rednote Note Comments
I commenti alle note di Rednote sono risposte pubbliche associate a una nota specifica e possono includere il testo della risposta, l’identità dell’autore, la data di pubblicazione, il riferimento al thread e i conteggi visibili delle interazioni. Aiutano chi fa ricerca a conservare ciò che le persone hanno detto intorno a una nota scelta, mantenendo ogni osservazione collegata alla fonte e al momento della raccolta.
Funzionalità della Rednote Note Comments API
- Input flessibile con link di condivisione RednoteInvia un riferimento ospitato su xiaohongshu.com, xhslink.com o su un sottodominio; il validatore di note-comments non richiede un percorso, una query string o un xsec_token particolari.
- Record di commenti stabiliRicevi ID dei commenti, testo, URL della fonte, timestamp e identità dell’autore, quando disponibile, nella struttura di risultato normalizzata CommentItem 1.0.
- Riferimenti a nota e threadConserva post_id e parent_id, quando presenti, così i commenti restituiti restano associati alla propria nota e al contesto padre disponibile.
- Campi di engagement puntualiMantieni likes_count e replies_count disponibili accanto a collected_at, senza trasformare i valori mancanti in zero e senza far credere a una copertura completa delle risposte.
Parametri della Rednote Note Comments API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Riferimento obbligatorio non vuoto. La validazione a runtime accetta xiaohongshu.com, xhslink.com e i relativi sottodomini senza imporre un pathname né richiedere xsec_token; usa un vero link di condivisione della nota, così il provider può risolvere la nota voluta. |
Come usare la Rednote Note Comments API
Invia un link di nota Rednote supportato, segui l’attività asincrona e leggi i commenti normalizzati salvati.
- Copia un vero link di condivisione di una nota Rednote su xiaohongshu.com o xhslink.com.
- Invia con POST url a /v1/rednote/note-comments e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
- Leggi data.results.items; segui next_cursor solo quando has_more è true per scorrere i risultati salvati dell’attività.
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://xhslink.com/{share_code}"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Rednote Note Comments API
- Codifica qualitativa delle risposte: Esamina il testo pubblico restituito e il contesto disponibile sugli autori per organizzare domande, reazioni o temi ricorrenti della discussione attorno a una nota selezionata.
- Archivi di commenti collegati alla fonte: Conserva ID dei commenti, URL della fonte, post_id, parent_id, published_at e collected_at per record di ricerca tracciabili.
- Revisione delle istantanee di engagement: Confronta i conteggi disponibili di Mi piace e risposte tra i commenti restituiti, ancorando ogni osservazione al momento della raccolta.
Consigli degli esperti per la Rednote Note Comments API
- Usa il link di condivisione completo copiato per la nota voluta; superare la sola validazione dell’hostname non garantisce che il provider riesca a risolvere un percorso non correlato.
- Non inventare né richiedere a parte xsec_token. Quella regola appartiene alla specifica di note-detail, non a rednote/note-comments.
- Non inviare results_limit né un cursore del provider: l’invio prevede solo url e fa una sola richiesta alla fonte.
- Tratta parent_id, post_id, timestamp, attributi dell’autore e metriche come campi della fonte nullable, non come valori garantiti.
- Tieni separata la profondità di raccolta dalla fonte da next_cursor, che scorre solo i record normalizzati già salvati per un’attività completata.
API correlate
Oltre alla Rednote Note Comments API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.