rednote/
comment-replies

Raccogli una pagina pubblica di risposte sotto un commento Rednote noto, con testo, autori, relazioni del thread, date e metriche visibili normalizzati.

Rednote Comment Replies API

Commento noto
Risposte annidate
Una pagina della fonte
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 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

ParametriObbligatorioDescrizione
urlObbligatorioURL 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_idObbligatorioIdentificatore 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.

  1. Scegli l’URL di una nota pubblica di xiaohongshu.com o xhslink.com e verifica un ID commento compatibile della stessa nota.
  2. Invia con POST url e comment_id a /v1/rednote/comment-replies e conserva il task_id restituito.
  3. Interroga GET /v1/tasks/{task_id} mentre l’attività è in coda, in esecuzione o in nuovo tentativo; fermati con succeeded o failed.
  4. 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 succeeded

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

Esplora altre piattaforme

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

Rednote Comment Replies API — FAQ

Rednote Comment Replies API raccoglie una pagina pubblica della fonte con le risposte a un commento Rednote noto, restituendo campi normalizzati di risposta, autore, relazioni, data e metriche visibili.

Sono obbligatori sia url sia comment_id. L’URL identifica il contesto della nota pubblica di Rednote, mentre comment_id seleziona il commento di origine di cui si richiedono le risposte annidate.

Qui non viene applicata alcuna regola specifica dell’endpoint su percorso o query. Il validatore di runtime richiede un host xiaohongshu.com o xhslink.com analizzabile, compresi i relativi sottodomini; un URL formalmente accettato ma non pertinente può comunque fallire alla fonte.

Usa un record pubblico di origine verificato per un commento della nota inviata. Una raccolta di commenti a monte compatibile può esporre un id normalizzato quando il provider lo fornisce, ma quel campo è facoltativo e non è garantito in ogni record.

Un CommentItem può contenere ID, piattaforma, risorsa, tipo, URL di origine, testo pubblico, campi dell’autore, parent_id, post_id, date di pubblicazione e di raccolta, più likes_count e replies_count visibili. I campi nullable restano null quando non sono disponibili.

No. La specifica di invio non accetta nessuno dei due campi ed esegue una sola richiesta alla fonte. Dopo il successo, next_cursor può scorrere le righe già archiviate nell’attività SocQ, ma non prosegue la raccolta del provider.

Ogni attività completata con successo costa 1 credito SocQ fisso, indipendentemente da quante risposte vengono salvate dalla pagina della fonte.