rednote/
user-notes

Raccogli una pagina di note pubbliche di Rednote da un URL utente o da un ID utente supportati, con testo, autori, media, timestamp ed engagement visibile normalizzati.

Rednote User Notes API

URL utente o ID utente
Una pagina della fonte
Note pubbliche normalizzate
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 User Notes

Le note utente di Rednote sono pubblicazioni pubbliche di un account, con testo, attribuzione dell’autore, media, data di pubblicazione e conteggi visibili di engagement. Questi campi di contenuto e di contesto supportano la ricerca sugli account, la revisione degli schemi di pubblicazione, il confronto tra formati e l’analisi puntuale delle prestazioni.

Funzionalità della Rednote User Notes API

  • Due input di identità dell’account con precedenza definitaAccetta un riferimento utente Rednote supportato oppure user_id, usando user_id esplicito quando vengono forniti entrambi i campi.
  • Raccolta delle note di un account a pagina singolaRecupera le note pubbliche restituite da una sola richiesta alla fonte per l’account selezionato, senza esporre un cursore della fonte né un limite di risultati definito da chi chiama.
  • Contesto di nota e autore normalizzatoRestituisce ID delle note, URL pubblici, testo, identità dell’autore, riferimenti ai media, data di pubblicazione e momento della raccolta in una struttura PostItem coerente.
  • Istantanee di engagement visibileConserva i conteggi disponibili di Mi piace, commenti, condivisioni e visualizzazioni insieme a collected_at per confronti limitati nel tempo.

Parametri della Rednote User Notes API

ParametriObbligatorioDescrizione
urlObbligatorio (almeno uno)Riferimento utente Rednote non vuoto il cui hostname analizzato sia xiaohongshu.com, xhslink.com o un sottodominio di uno dei due host. Non è richiesto alcun modello di percorso; quando l’URL contiene /user/<identifier> e user_id è vuoto, viene usato quell’identificatore, altrimenti l’URL accettato resta il riferimento all’account.
user_idObbligatorio (almeno uno)Identificatore utente Rednote composto da 1 a 256 lettere ASCII, numeri, due punti, trattini bassi o trattini. Fornisci url o user_id; quando sono presenti entrambi, user_id esplicito ha la precedenza.

Come usare la Rednote User Notes API

Invia l’identità di un account Rednote supportato, segui l’attività asincrona, poi scorri i record delle note normalizzati salvati.

  1. Prepara un URL utente Rednote non vuoto su un host accettato oppure un user_id valido; lascia vuoto l’altro campo quando non serve.
  2. Invia con POST url o user_id a /v1/rednote/user-notes 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 e segui next_cursor finché has_more è true; questo cursore scorre i record salvati, non altre pagine della fonte Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_USER_URL\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Rednote User Notes API

  • Inventario delle pubblicazioni di un account pubblico: Usa ID delle note, URL pubblici, testo, attribuzione dell’autore e data di pubblicazione per catalogare l’istantanea dell’account restituita.
  • Revisione dei formati di contenuto: Confronta i riferimenti disponibili a immagini e video, le dimensioni, le miniature e il testo delle note restituite per l’account.
  • Analisi degli schemi di pubblicazione: Ordina le note per published_at ed esamina insieme testo e media per rivedere il mix di pubblicazione visibile dell’account all’interno dell’istantanea.
  • Confronto puntuale dell’engagement: Confronta Mi piace, commenti, condivisioni e visualizzazioni visibili usando collected_at per legare ogni osservazione al proprio momento di raccolta.

Consigli degli esperti per la Rednote User Notes API

  • Usa un user_id stabile quando ne hai già uno; ha la precedenza su url ed evita ambiguità tra due riferimenti all’account.
  • Quando invii url, verifica il suo hostname rispetto a xiaohongshu.com o xhslink.com; non è richiesto alcun modello di percorso specifico.
  • Se un URL supportato contiene /user/<identifier>, conferma che il percorso identifichi l’account voluto, perché quell’identificatore viene usato quando user_id è vuoto.
  • Non aggiungere results_limit né un cursore della fonte all’invio; ogni attività fa una sola richiesta alla fonte per una pagina.
  • Usa cursor e limit solo su GET /v1/tasks/{task_id} dopo il completamento; limit vale 50 per impostazione predefinita e accetta da 1 a 500 per i risultati salvati.
  • Gestisci testo, campi dell’autore, media, data di pubblicazione, hashtag, menzioni e singole metriche come nullable ed esegui l’escape del testo pubblico prima di mostrarlo.

Esplora altre piattaforme

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

Rednote User Notes API — FAQ

Rednote User Notes API raccoglie una pagina di note pubbliche da un URL utente o da un ID utente Rednote supportati, restituendo identità della nota, testo, contesto dell’autore, media, timestamp ed engagement visibile in forma normalizzata.

Fornisci almeno uno dei due campi. Se sono presenti entrambi, user_id ha la precedenza; altrimenti, quando disponibile, viene risolto un percorso /user/<identifier> e un altro URL accettato viene usato come riferimento all’account.

L’hostname analizzato deve essere xiaohongshu.com, xhslink.com o un sottodominio di uno dei due. L’endpoint non richiede un percorso particolare, ma il valore deve comunque riferirsi all’account pubblico voluto.

No. La specifica di invio non prevede results_limit né un cursore della fonte e fa una sola richiesta alla fonte. La paginazione a cursore di GET /v1/tasks/{task_id} legge solo i record già salvati per quell’attività.

Un risultato può contenere il proprio ID e URL pubblico, testo, identità dell’autore, media, published_at, collected_at, hashtag, menzioni e conteggi visibili di Mi piace, commenti, condivisioni e visualizzazioni. I campi facoltativi della fonte possono essere null.

Rednote User Notes usa una fatturazione fissa di 1 credito SocQ per attività e non per nota restituita. Il numero di risultati non cambia l’addebito configurato.