rednote/
note-comments

Raccogli una pagina di commenti pubblici di Rednote da un URL di nota xiaohongshu.com o xhslink.com, con testo, autori, timestamp, riferimenti alla nota ed engagement visibile.

Rednote Note Comments API

URL della nota in input
Una sola richiesta alla fonte
Commenti normalizzati
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 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

ParametriObbligatorioDescrizione
urlObbligatorioRiferimento 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.

  1. Copia un vero link di condivisione di una nota Rednote su xiaohongshu.com o xhslink.com.
  2. Invia con POST url a /v1/rednote/note-comments e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non ha successo o segnala un errore.
  4. 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 true

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

Esplora altre piattaforme

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

Rednote Note Comments API — FAQ

Rednote Note Comments API raccoglie una pagina di risposta della fonte con i commenti pubblici associati a un link di nota Rednote specificato.

Il runtime richiede un url non vuoto il cui hostname analizzato sia xiaohongshu.com, xhslink.com o un sottodominio. Non impone un percorso o una query specifici, ma per una risoluzione sensata da parte del provider serve un vero link di condivisione della nota.

No. rednote/note-comments applica solo il validatore condiviso degli hostname Rednote. I controlli più rigidi su percorso e xsec_token valgono per la specifica separata di note-detail.

No. La specifica di invio accetta solo url e l’integrazione con il provider fa una sola richiesta alla fonte, senza paginazione della fonte controllabile da chi chiama.

Il lettore condiviso dei risultati delle attività può scorrere i record CommentItem già salvati da un’attività riuscita. Quel cursore opaco di SocQ non richiede un’altra pagina della fonte Rednote.

Un’attività Rednote Note Comments riuscita costa un credito SocQ fisso di 1,00, indipendente dal numero di commenti restituiti dall’unica richiesta alla fonte.