Rednote Comment Replies
Le risposte ai commenti di Rednote sono risposte pubbliche annidate sotto un commento selezionato di una nota, con testo della risposta, contesto dell’autore, date e campi disponibili di relazione o engagement. I record normalizzati aiutano i team a ispezionare un singolo ramo di conversazione noto, senza mescolare l’identificatore del commento di origine con la paginazione dei risultati archiviati.
Funzionalità della Rednote Comment Replies API
- Riferimento abbinato del threadIndividua un ramo di conversazione con l’URL pubblico della nota e con l’identificatore del commento che le appartiene.
- Acquisizione delle risposte di una sola paginaEsegue una sola richiesta alla fonte e salva le risposte restituite in quella pagina, senza esporre un cursore del provider né un limite di risultati al momento dell’invio.
- Corpo della risposta normalizzatoLeggi ID della risposta, testo pubblico, URL di origine, data di pubblicazione e momento della raccolta nella forma CommentItem condivisa.
- Contesto pubblico dell’autoreMantiene accanto a ogni risposta ID dell’autore, nome utente, nome visualizzato, URL del profilo, avatar e flag dell’account, quando disponibili.
- Relazioni della conversazioneConserva i collegamenti parent_id e post_id disponibili insieme ai conteggi visibili di Mi piace e risposte per un’elaborazione consapevole del thread.
Parametri della Rednote Comment Replies API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL pubblico obbligatorio il cui host sia xiaohongshu.com, xhslink.com o un sottodominio di uno dei due. Questo endpoint non aggiunge alcun modello di percorso né l’obbligo del parametro xsec_token nella query. |
comment_id | Obbligatorio | Identificatore obbligatorio del commento di origine, composto da 1 a 256 lettere ASCII, numeri, due punti, trattini bassi o trattini. |
Come usare la Rednote Comment Replies API
Invia l’URL di una nota Rednote e l’ID di un suo commento, poi leggi il risultato di una sola pagina di risposte tramite il flusso di lavoro con attività asincrona di SocQ.
- Scegli l’URL di una nota pubblica di xiaohongshu.com o xhslink.com e verifica un ID commento compatibile della stessa nota.
- Invia con POST url e comment_id a /v1/rednote/comment-replies e conserva il task_id restituito.
- Interroga GET /v1/tasks/{task_id} mentre l’attività è in coda, in esecuzione o in nuovo tentativo; fermati con succeeded o failed.
- Dopo il successo, leggi data.results.items e usa data.results.next_cursor solo per scorrere le righe di risposte già archiviate da SocQ.
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededCasi d’uso della Rednote Comment Replies API
- Revisione mirata di una conversazione: Leggi testo e date delle risposte pubbliche di un solo ramo di commenti selezionato, invece di mescolare le risposte di un’intera nota.
- Arricchimento del contesto dei partecipanti: Associa a ogni risposta l’identità normalizzata dell’autore, quando disponibile, nella preparazione di record per ricerca sulla moderazione o revisione manuale.
- Mappatura delle relazioni del thread: Usa gli ID delle risposte con parent_id e post_id per ricollegare i record archiviati al commento e alla nota di origine, quando questi campi sono presenti.
- Istantanee delle reazioni in un preciso momento: Conserva collected_at accanto ai conteggi visibili di Mi piace o risposte, così le esecuzioni separate restano osservazioni distinguibili.
Consigli degli esperti per la Rednote Comment Replies API
- Verifica che comment_id appartenga all’URL della nota inviata; l’endpoint convalida il formato di ogni campo ma non verifica questa relazione prima della richiesta alla fonte.
- Usa un URL pubblico completo su xiaohongshu.com, xhslink.com o un sottodominio accettato, anche se questo validatore non richiede un percorso di nota particolare né il parametro di query xsec_token.
- Mantieni comment_id nel modello di identificatore ASCII accettato, da 1 a 256 caratteri, e non sostituirlo con un ID interno del database o con un ID attività di SocQ.
- Considera condizionale un ID commento proveniente da un’altra raccolta: gli ID normalizzati dei commenti sono facoltativi, quindi verifica che sia presente un valore utilizzabile prima di inviarlo qui.
- Non aggiungere results_limit né un cursore della fonte al payload di invio; questo endpoint esegue una sola richiesta al provider per una sola pagina della fonte.
- Tieni next_cursor dei risultati dell’attività separato da comment_id, perché quel cursore pagina solo le righe normalizzate salvate dopo il successo dell’attività.
- Ammetti campi nullable di identità, relazioni, date e metriche e applica l’escape al testo delle risposte pubbliche prima di mostrarlo in un altro prodotto.
API correlate
Oltre alla Rednote Comment Replies API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.