Torna alle API
Dati pubblici di Rednote

Rednote Public Data APIs

Recupera profili e note pubblici, cerca note o utenti, raccogli commenti e risposte annidate e acquisisci una pagina di consigli della home.

API di Rednote disponibili

Scegli tra otto API per i flussi di lavoro su profili, note, commenti, risposte, ricerca e consigli.

Quali dati di Rednote puoi recuperare?

Il catalogo di Rednote restituisce record normalizzati di account, post e commenti a partire da dati di origine pubblici.

Profili e note degli utenti

Risolvi un profilo pubblico o raccogli una pagina di note della fonte usando l’URL di un account supportato o un user_id.

Dettagli delle note e scoperta

Recupera l’URL di una nota con token, cerca note con i filtri supportati oppure raccogli una pagina di consigli della home.

Ricerca di utenti

Cerca nella prima pagina fissa della fonte gli account pubblici, con una sola query non vuota.

Commenti e risposte

Raccogli una pagina di commenti pubblici di una nota o una pagina di risposte per l’ID di un commento noto.

Le specifiche delle API di Rednote in sintesi

Ogni endpoint ha una richiesta alla fonte limitata e rifiuta i parametri non dichiarati.

Gruppo di APIInput inizialeLimite della fonte
Profilo e note degli utentiurl o user_idUn profilo o una pagina della fonte; nessun results_limit
Dettaglio della notaURL supportato con percorso della nota e xsec_tokenAl massimo un record di nota
RicercaQuery non vuota e valori enum facoltativi supportatiPrima pagina fissa della fonte; nessun results_limit
Commenti e risposteURL di nota supportato; le risposte richiedono anche comment_idUna pagina di risposta della fonte
Consigli della homeTutti i campi sono facoltativiUna pagina con results_limit 1–40, valore predefinito 20

Come funzionano le API di Rednote

Tutti e otto gli endpoint usano lo stesso flusso di lavoro: invio, interrogazione e risultati archiviati.

  1. 1. Scegli l’endpoint

    Seleziona l’endpoint per profili, note, ricerca, commenti, risposte o consigli adatto alla tua attività sui dati pubblici.

  2. 2. Invia un input valido

    Invia con POST solo i campi dichiarati e salva il task_id restituito.

  3. 3. Leggi i risultati normalizzati

    Interroga l’attività fino a uno stato finale, poi leggi data.results.items e usa next_cursor solo per la paginazione dei risultati archiviati.

Cerca note pubbliche di Rednote

Autenticati con una chiave API di SocQ e invia una query con i filtri facoltativi supportati. Ogni attività Rednote completata con successo costa 1 credito fisso.

curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"travel guide","sort_by":"general","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Casi d’uso comuni delle API di Rednote

Ricerca su creator e contenuti

Combina l’identità pubblica dell’account con una pagina limitata di note scritte dall’autore.

Scoperta di argomenti

Confronta le istantanee di ricerca di note, ricerca di utenti e consigli della home con le date di raccolta.

Revisione delle conversazioni

Ispeziona come record normalizzati i commenti di una nota pubblica e le risposte annidate di un commento selezionato.

Limiti e policy sui dati pubblici

Questi endpoint leggono dati pubblici con richieste alla fonte limitate e non offrono azioni sugli account né accesso a dati privati.

  • Gli host URL supportati sono xiaohongshu.com, xhslink.com e i relativi sottodomini; Note Detail richiede inoltre un percorso /explore/{id} o /discovery/item/{id} e un xsec_token non vuoto.
  • user_id e comment_id accettano da 1 a 256 lettere ASCII, numeri, due punti, trattini bassi o trattini.
  • Search Notes accetta sort_by, media_type e published_within solo con i valori enum elencati; Search Users accetta solo query.
  • Solo Home Recommendations accetta results_limit, con un intervallo da 1 a 40 e un valore predefinito di 20.
  • Ogni attività Rednote completata con successo costa 1 credito fisso.

Domande frequenti sulle API di Rednote

Che cosa sono le API di Rednote?

Le API di Rednote recuperano come record normalizzati profili, note, commenti, risposte annidate, risultati di ricerca e consigli della home pubblici.

Quale endpoint accetta results_limit?

Solo Home Recommendations accetta results_limit, come numero intero da 1 a 40. Gli altri endpoint di Rednote lo rifiutano.

Note Detail accetta qualsiasi URL di Rednote?

No. Richiede un host accettato, un percorso /explore/{id} o /discovery/item/{id} e un valore xsec_token non vuoto nella query.

Quanto costano le richieste a Rednote?

Ogni attività completata con successo costa 1 credito SocQ fisso.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.