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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio (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_id | Obbligatorio (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.
- Prepara un URL utente Rednote non vuoto su un host accettato oppure un user_id valido; lascia vuoto l’altro campo quando non serve.
- Invia con POST url o user_id a /v1/rednote/user-notes 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 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 trueCasi 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.
API correlate
Oltre alla Rednote User Notes API, usa queste API quando ti serve un altro tipo di dati pubblici di Rednote.