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.

rednote/comment-replies
Commenti1 credito per richiesta

rednote/home-recommendations
Post1 credito per richiesta

rednote/note-comments
Commenti1 credito per richiesta

rednote/note-detail
Post1 credito per richiesta

rednote/search-notes
Ricerca1 credito per richiesta

rednote/search-users
Ricerca1 credito per richiesta

rednote/user-notes
Post1 credito per richiesta

rednote/user-profile
Profili1 credito per richiesta
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 API | Input iniziale | Limite della fonte |
|---|---|---|
| Profilo e note degli utenti | url o user_id | Un profilo o una pagina della fonte; nessun results_limit |
| Dettaglio della nota | URL supportato con percorso della nota e xsec_token | Al massimo un record di nota |
| Ricerca | Query non vuota e valori enum facoltativi supportati | Prima pagina fissa della fonte; nessun results_limit |
| Commenti e risposte | URL di nota supportato; le risposte richiedono anche comment_id | Una pagina di risposta della fonte |
| Consigli della home | Tutti i campi sono facoltativi | Una 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. Scegli l’endpoint
Seleziona l’endpoint per profili, note, ricerca, commenti, risposte o consigli adatto alla tua attività sui dati pubblici.
2. Invia un input valido
Invia con POST solo i campi dichiarati e salva il task_id restituito.
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.
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 successCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
Kwai API
Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.
Truth Social API
Recupera i dettagli pubblici di un account, raccogli una pagina della fonte con i post di un account o risolvi l’URL di un post noto in record normalizzati.
Google Ad Library API
Trova gli inserzionisti pubblici, raccogli le creatività di un’azienda o recupera per URL una creatività nota del Transparency Center, per ricerca e verifica.
Google Maps API
Trova i luoghi pubblici, recupera dettagli normalizzati da URL noti di Maps e raccogli le recensioni pubbliche con il contesto di luogo e autore collegato alla fonte.
Amazon API
Cerca i prodotti pubblici di Amazon e raccogli dettagli dei prodotti, Best Sellers, recensioni, profili dei venditori e vetrine dei creator normalizzati dai marketplace supportati.
Apple App Store API
Raccogli dettagli delle app, classifiche per categoria e recensioni pubblici di Apple App Store da URL noti dello store, come record normalizzati di app e recensioni.