API di Xiaohongshu: piattaforma ufficiale, script su GitHub o pagamento per chiamata

Chi cerca una «xiaohongshu api» o una «rednote api» di solito vuole i post e i commenti pubblici di altri account. Al 4 novembre 2026, la piattaforma aperta ufficiale di Xiaohongshu non lo permetteva. La sua piattaforma per gli account apriva un solo scope di autorizzazione, basic_info, con quattro campi: nickname, avatar, genere e regione. Lo scope che legge le note è ancora segnato come «pianificato» (elenco degli scope). Abbiamo anche analizzato nove scraper open source popolari su GitHub.

Negli ultimi 90 giorni hanno ricevuto 92 nuove issue, e 31 di queste segnalano un login non funzionante, una richiesta bloccata o una modifica della pagina. Poi abbiamo pagato nove chiamate reali tramite EveryInfra. Ogni chiamata è costata 0,005556 $. Una pagina di ricerca ha restituito 20 post, cioè 0,278 $ per 1.000 post. I risultati vuoti e i parametri sbagliati non costano nulla.

Questo articolo mette a confronto tre modi per ottenere i dati di Xiaohongshu. Il primo è la piattaforma aperta ufficiale. Il secondo è uno script open source che gira con il tuo login. Il terzo è un'API per i dati di terze parti che addebita per richiesta.

Per i primi due abbiamo usato solo materiale pubblico: la documentazione ufficiale per gli sviluppatori, i dati pubblici di GitHub e le issue pubbliche. Per il terzo abbiamo usato la nostra API, EveryInfra, e riportiamo l'addebito reale di ogni risposta. Non citiamo altri servizi di terze parti. La sezione sul confronto dei prezzi di terze parti fornisce una formula, così puoi convertire da solo qualsiasi listino.

In breve: cosa può e non può fare ciascuna strada

Le tre strade non sono tre prezzi per la stessa cosa: raggiungono dati diversi. La piattaforma ufficiale è pensata per le tue risorse: il login della tua app, gli ordini del tuo negozio e i report dei tuoi annunci. Non ha endpoint per cercare i post di altri o leggere i commenti di altri.

Uno script su GitHub può leggere quasi tutto ciò che vedi nel browser, perché si comporta come un browser con il tuo login. Quindi cosa riesce a leggere, e per quanto tempo, dipende dal tuo account e dallo stato del sito in quella settimana. Un'API a pagamento per chiamata trasforma la stessa attività in una normale richiesta HTTP. Paghi ogni richiesta, e i dati disponibili e le righe per pagina sono quelli che il fornitore indica nel suo catalogo pubblico.

La prima riga è quella che molti trascurano. Un piano comune è «prima chiedo l'API ufficiale, e cerco altrove solo se mi dicono di no». Ma oggi gli scope relativi ai contenuti pubblici, user_profile, read_notes e read_followers, sono tutti chiusi. Anche con un'app approvata ottieni il nickname e l'avatar dell'utente che effettua l'accesso. Le sezioni seguenti analizzano ogni strada, citando per ogni affermazione il testo della fonte o i dati dei nostri test.

Esiste un'API ufficiale di Xiaohongshu? Quattro porte, quattro usi diversi

Sì, e ce n'è più di una. Ognuna serve a uno scopo diverso. Il 4 novembre 2026 abbiamo aperto tutti i siti pubblici per sviluppatori di Xiaohongshu e, per ciascuno, abbiamo annotato a chi si rivolge, i requisiti di accesso e i dati che fornisce.

La piattaforma account è la porta più recente. La sua home page dice che offre alla tua app il login con Xiaohongshu tramite OAuth 2.0 standard (portale per sviluppatori). La guida rapida dice che una nuova app attende circa da 1 a 3 giorni lavorativi per la revisione. Precisa anche che al momento è aperto solo lo scope basic_info (guida rapida). La pagina degli scope ne elenca cinque.

Solo basic_info ha lo stato «aperto». Gli altri quattro sono «pianificati», e per write_notes è indicato anche che richiede una revisione manuale e viene aperto solo in casi particolari (elenco degli scope). La reference dell'API contiene 11 endpoint, tutti relativi a token e login: verificano lo stato, ottengono e aggiornano un token, recuperano le informazioni di base dell'utente, revocano l'accesso ed eseguono il login tramite QR code per gli schermi delle auto e le pagine web. La pagina è stata aggiornata l'ultima volta il 19 agosto 2026 e indica per il refresh token una durata di 180 giorni (reference dell'API).

La piattaforma aperta per l'e-commerce è la porta che i titolari di negozi conoscono. Prevede due ruoli per gli sviluppatori. Un fornitore di software crea strumenti per ordini, prodotti o ERP per molti negozi Xiaohongshu e pubblica l'app in un marketplace di servizi. Uno sviluppatore in proprio crea strumenti solo per il proprio negozio. I requisiti di accesso sono rigidi. Un fornitore deve essere un'azienda registrata nella Cina continentale da più di un anno, con lo sviluppo tecnico o i servizi tecnici nel proprio oggetto sociale.

Uno sviluppatore in proprio non può essere un negozio individuale (guida ai ruoli per sviluppatori, un mirror di terze parti della documentazione della piattaforma). La guida all'autorizzazione dice che solo l'account principale del negozio può autorizzare un'app. Il codice di autorizzazione dura 10 minuti, l'access token 7 giorni e il refresh token 14 giorni (flusso di autorizzazione per i fornitori).

Ogni chiamata di business passa da un unico indirizzo gateway. Ogni chiamata include una firma MD5 di appId, timestamp, version, method e app secret (metodo di firma). Questa porta collega il tuo negozio ai tuoi sistemi. Il suo perimetro di dati è il negozio che ti ha autorizzato.

Le regole sui token mostrano quanto è stretta ogni porta. Abbiamo messo a confronto le durate pubblicate:

La terza porta è la Marketing API per la pubblicità. La sua guida introduttiva dice che l'API è destinata a clienti di settori chiave che fanno già pubblicità sulla piattaforma e hanno esperienza con le API. È un sales manager della piattaforma ad avviare la registrazione come sviluppatore (guida introduttiva alla Marketing API). Fornisce report e controllo delle campagne per il tuo account pubblicitario, non i post organici.

La quarta porta è la piattaforma di condivisione, che offriva alle altre app la «condivisione con un tocco» e la «pubblicazione rapida» (piattaforma di condivisione). A novembre 2025 uno sviluppatore ha scritto che la pagina non aveva un pulsante di registrazione e mostrava uno stato di sospensione (post sul forum). Quando l'abbiamo aperta il 4 novembre 2026, non c'era ancora alcun accesso alla registrazione. Esiste anche una piattaforma per mini program, per le app che girano dentro Xiaohongshu (piattaforma mini program), e anche questa non legge i contenuti della community.

Cosa non ti offre la piattaforma ufficiale

Mettendo insieme le quattro porte, il risultato è semplice. Le API ufficiali guardano verso l'interno: coprono il tuo account, il tuo negozio e le tue inserzioni. Nessuna delle quattro porte documenta un endpoint per terze parti che permetta di cercare tra tutti i post, leggere qualsiasi commento o aprire qualsiasi profilo pubblico. Nella pagina degli scope, read_notes e read_followers sono ancora «pianificati».

Per chi legge da fuori della Cina continentale c'è un secondo documento. Gli utenti che si registrano fuori dalla Cina continentale sono utenti RedNote. Sono soggetti ai termini di RedNote, in vigore dal 9 giugno 2026, con Rednote Technology Pte. Ltd. come gestore (RedNote Terms of Service). La sezione sulla conformità, più avanti, spiega cosa dicono entrambi i termini sulla lettura automatizzata.

Quindi la domanda «rednote api» ha la stessa risposta della domanda «xiaohongshu api»: in nessuna delle due versioni esiste un'API ufficiale di lettura per i contenuti pubblici.

Quindi la ricerca «xiaohongshu api» nasconde due esigenze diverse. Se ti serve il login per la tua app, un collegamento al tuo negozio o i report del tuo account pubblicitario, usa la porta ufficiale. Puoi smettere di leggere qui. Se ti servono monitoraggio dei concorrenti, ascolto del brand, ricerca di prodotto o trend dei contenuti, oggi le porte ufficiali non ti aiutano. Le alternative sono uno script o un'API di terze parti.

In entrambi i casi devi conoscere bene i limiti legali, di cui parliamo nella sezione sulla conformità più avanti. Molti chiedono anche dell'API del creator marketplace. Uno sviluppatore su un forum cinese ha scritto che puoi chiamarne gli endpoint delle pagine con il tuo cookie. Un altro sviluppatore, nello stesso thread, ha risposto che restituiva solo i primi commenti in evidenza e che la paginazione non funzionava (thread sul forum). Anche questo metodo usa il tuo login sugli endpoint delle pagine, quindi rientra nella strada degli script descritta nella prossima sezione.

API di Xiaohongshu su GitHub: abbiamo misurato nove repository popolari

Gli script open source sono la prima scelta di molti sviluppatori, perché sono gratuiti e puoi leggerne il codice. Non volevamo scrivere «gli script si rompono spesso» a memoria, quindi il 4 novembre 2026 alle 00:19:50 (ora di Singapore) abbiamo campionato GitHub tramite la GitHub API. La regola era semplice. Abbiamo cercato su GitHub xiaohongshu, xhs spider e il nome cinese dell'app. Per ogni query abbiamo preso i primi 30 risultati per numero di stelle e rimosso i duplicati.

Poi abbiamo tenuto solo i repository il cui compito principale è ottenere dati: crawler, wrapper di richieste, server MCP, strumenti da riga di comando e downloader. Abbiamo escluso gli strumenti che si limitano a pubblicare post, creare immagini o scaricare video da molti siti. Sono rimasti nove repository. «Issue in 90 giorni» indica le issue aperte dal 6 agosto al 4 novembre 2026, escluse le pull request (GitHub issues API).

Abbiamo letto il titolo di ogni issue e l'abbiamo assegnata a mano a uno di quattro gruppi. Il primo gruppo riguarda errori di login, cookie, QR code o sessione (10 issue). Il secondo riguarda controlli di verifica, ricerca limitata o richieste bloccate (3 issue). Il terzo riguarda un passaggio di lettura, parsing o automazione fallito o andato in timeout dopo una modifica a una pagina o a un endpoint (18 issue).

Le altre 61 issue sono richieste di funzionalità, problemi di installazione, avvisi di sicurezza, post promozionali o titoli senza un contenuto chiaro. I titoli possono trarre in inganno. Per esempio, tre issue avevano nel titolo solo la parola «problema» e le abbiamo messe nel gruppo «altro». Quindi 31 è un limite inferiore.

Questi numeri non significano che i progetti più attivi siano scadenti. È vero il contrario: un progetto riceve molte issue perché lo usano in tanti e il maintainer è attivo. xiaohongshu-mcp ha avuto 35 commit in 30 giorni. Tra le sue issue recenti ci sono «non riesco ad accedere» (#880, 23 ottobre) e «la ricerca è limitata, ma l'app per smartphone funziona» (#877, 21 ottobre). Un utente ha chiesto direttamente se la piattaforma consente l'uso dello strumento.

Lo stesso utente ha chiesto se lo strumento potesse ridurre la visibilità dei suoi post (#878, 22 ottobre). La issue #497 di XHS-Downloader (17 ottobre) mostra una tipica modifica di pagina: i dati lato server nella pagina web hanno iniziato a usare una nuova sintassi e il parser si è bloccato. Nello stesso repository, la #479 chiede un'impostazione per rallentare il crawling ed evitare di attivare le difese del sito. Il titolo della issue #191 di Spider_XHS (10 ottobre) è semplicemente «Cookie non valido o scaduto».

L'altro rischio è un progetto che nessuno mantiene. ReaJason/xhs è un wrapper di richieste per il sito web di Xiaohongshu. Il suo ultimo commit risale al 1° luglio 2025, cioè 490 giorni fa. xiaohongshu-cli si è fermato il 21 marzo 2026. L'assenza di nuove issue non significa che il codice funzioni.

Può significare che gli utenti se ne sono andati. Prima di scegliere uno script per un job giornaliero, controlla tre cose. Guarda la data dell'ultimo commit. Leggi le issue dell'ultimo mese cercando errori di login, scadenza o parsing. Verifica quanto velocemente risponde il maintainer.

I costi reali degli script: login, firme, separazione di RedNote e licenze

Il primo costo è il login. Quasi tutti gli script più diffusi ti chiedono di accedere e salvare il cookie. Il README di xiaohongshu-mcp dice in grassetto che un account non può restare connesso su più client web. Se accedi da un altro client web, lo strumento viene disconnesso. L'autore avverte anche che un account nuovo senza verifica dell'identità reale attiverà un controllo di verifica (README di xiaohongshu-mcp).

Un utente di xiaohongshu-cli si è lamentato nella #82 che lo strumento imponeva un nuovo login ogni 7 giorni. Quando il login scade, il job pianificato si ferma e spesso te ne accorgi solo quando il report successivo è vuoto. Anche l'account stesso è a rischio. La sezione 2.3 del contratto d'uso dice che un account è riservato al titolare. Cederlo a terzi non è valido e la piattaforma può bloccare gli account che considera a rischio (contratto d'uso). Considera l'account che esegue il tuo script come qualcosa che puoi perdere in qualsiasi momento.

Il secondo costo è la firma delle richieste. Le richieste agli endpoint web di Xiaohongshu includono header di firma come x-s e x-s-common. Alcuni endpoint richiedono un ulteriore header anti-bot. Esistono interi repository dedicati a questo compito. Il README di xhshow dice che genera gli header x-s, x-s-common e x-rap-param, e aggiunge che gli endpoint di feed, ricerca e pubblicazione richiedono l'header aggiuntivo x-rap-param (Cloxl/xhshow).

MediaCrawler segue un altro approccio. Mantiene il login in un browser Playwright ed esegue JavaScript in quel browser per ottenere i valori della firma. Il suo README dice che si collega al Chrome già installato dall'utente, per ridurre il rischio di rilevamento (README di MediaCrawler). I due approcci hanno un punto debole in comune. Quando il metodo di firma cambia, tutti gli script che ne dipendono si fermano nello stesso momento. È una delle cause delle 18 issue di malfunzionamento viste sopra.

Il terzo costo conta soprattutto per chi legge da fuori della Cina: la separazione di RedNote. La issue #579 di xiaohongshu-mcp la spiega. Gli utenti che si sono registrati con un numero di telefono non cinese dopo l'8 dicembre 2025 sono utenti RedNote. La loro sessione web passa da rednote.com e i loro cookie usano il dominio .rednote.com.

Gli script che leggono solo i cookie di xiaohongshu.com continuano a segnalare «non connesso». Questo è coerente con il contratto d'uso, che sottopone gli utenti della Cina continentale e gli utenti RedNote a due insiemi di termini diversi. Se il tuo team a Singapore, Londra o New York ha aperto gli account con numeri di telefono locali nel 2026, molti tutorial non funzioneranno per te.

I due tipi di account seguono regole diverse. Questa tabella riunisce i fatti emersi dalla issue e dai due insiemi di termini:

Il quarto costo è la licenza, e molti la ignorano. La licenza di MediaCrawler è la «NON-COMMERCIAL LEARNING LICENSE 1.1». Dice che il software è destinato solo all'apprendimento e alla ricerca. Non puoi usarlo per il crawling su larga scala né per disturbare la piattaforma. L'uso commerciale richiede il consenso scritto del titolare del copyright (licenza di MediaCrawler).

Spider_XHS e xiaohongshu-cli non indicano una licenza su GitHub. GitHub spiega che, senza licenza, l'autore conserva tutti i diritti e nessun altro ha il permesso di usare, modificare o condividere il codice (documentazione GitHub sulle licenze). Un'azienda che inserisce questo codice in un prodotto o in una consegna a un cliente avrà vita difficile con il proprio ufficio legale.

API di scraping per Xiaohongshu a chiamata: cosa abbiamo testato

La terza strada è un'API per i dati addebitata per richiesta. Invii una richiesta HTTP, il fornitore restituisce una pagina di dati strutturati e paghi ogni richiesta. Il 4 novembre 2026, dalle 00:14 alle 00:20 ora di Singapore, abbiamo eseguito chiamate reali tramite EveryInfra. Abbiamo chiamato sei azioni di Xiaohongshu in nove chiamate a pagamento. Abbiamo anche fatto fallire di proposito tre richieste. Altre quattro richieste hanno raggiunto il limite di frequenza delle richieste (429) e sono andate a buon fine quando le abbiamo inviate di nuovo.

Per prima cosa abbiamo letto il catalogo gratuito per verificare parametri e prezzi (catalogo, consultato alle 00:13 ora di Singapore). Xiaohongshu ha 17 azioni. Sedici costano $0,005556 per chiamata e una classifica per il creator marketing costa $0,016. Ricerca, post degli utenti e ricerca prodotti restituiscono 20 righe per pagina, i commenti 15 e le risposte 10. Un page token resta valido per 24 ore.

Le nove chiamate sono costate in totale $0,061115, per 11 unità di fatturazione (il batch di 3 post conta come 3).

Dividiamo l'addebito per le righe effettivamente restituite, non per la dimensione di pagina indicata nel catalogo. Per questo le chiamate che hanno restituito 19 righe costano un po' di più per riga. Il divario maggiore riguarda il dettaglio del post. Costa gli stessi $0,005556 di una ricerca, ma una ricerca restituisce 20 post e una chiamata di dettaglio ne restituisce 1. Per riga, il dettaglio costa 20 volte di più. Per le analisi in blocco, usa i campi già inclusi nei risultati di ricerca (titolo, estratto del testo, like, salvataggi, numero di commenti, data e autore) e chiama l'azione di dettaglio solo quando ti serve altro.

Il test con la parola chiave inglese merita un'analisi più attenta per chi legge da fuori della Cina. Abbiamo cercato «Singapore food» senza altri filtri. La ricerca ha restituito 19 post, ma solo 4 titoli contenevano parole inglesi. Gli altri erano in cinese: la piattaforma associa una query inglese a contenuti cinesi sullo stesso argomento. Solo 3 dei 19 post avevano meno di 30 giorni e l'età mediana era di 242 giorni.

Succede perché l'ordinamento predefinito è per rilevanza e le guide evergreen si posizionano in alto. Il post con più commenti (412) era una lamentela per un pasto troppo caro, del settembre 2025. Un post sul durian economico di gennaio 2026 aveva 80 commenti. Per avere il quadro di questa settimana su un argomento, imposta sort su newest o aggiungi un date_range. Senza questi parametri leggerai soprattutto vecchie guide.

Le due parole chiave si comportano in modo molto diverso. Entrambe le ricerche hanno usato l'ordinamento predefinito:

Dal test sono emersi altri quattro dettagli. Primo, la paginazione avanza davvero: la pagina 2 non aveva alcun post in comune con la pagina 1. Dei 40 post, 21 avevano meno di 30 giorni, 12 meno di 7 giorni e il più vecchio 231 giorni. Secondo, la chiamata di dettaglio rilegge il post in tempo reale. Il post mostrava 231 commenti nel risultato di ricerca e 232 nella chiamata di dettaglio due secondi dopo. Il dettaglio aggiunge anche la regione IP, 8 tag di argomento e un elenco di 10 immagini.

Terzo, le risposte richiedono una chiamata a parte. I 15 commenti principali della pagina 1 dichiaravano 53 risposte, ma ogni commento ne includeva solo 1 inline. Per i thread completi, chiama xiaohongshu/sub_comments. Quarto, comments_batch addebita per post. Tre post costano tre volte $0,005556, quindi il prezzo per commento è lo stesso delle chiamate singole. Il batch fa risparmiare richieste e margine sul limite di frequenza delle richieste, non denaro.

Come collegarti: curl, campi della risposta e MCP

Il collegamento più semplice è una singola richiesta POST. Questa è la ricerca con parola chiave inglese della tabella. Tieni la chiave in una variabile d'ambiente, non nel codice:

curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"Singapore food","sort":"newest","date_range":"last_7_days"}}'
# Next page: copy next_page_token into params.page_token. For slow jobs add "mode":"async" and poll the job_id.

I campi della risposta corrispondono all'elenco response_fields del catalogo. La tabella mostra i gruppi che abbiamo usato e cosa abbiamo visto nel test:

Per i client AI, EveryInfra è un server MCP remoto. MCP (Model Context Protocol) è un protocollo aperto che permette a un client AI di chiamare strumenti esterni (specifica). Tutti i nomi degli strumenti iniziano con everyinfra_. Aggiungi questo blocco al client e puoi iniziare:

{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": { "Authorization": "Bearer ${env:EVERYINFRA_API_KEY}" }
    }
  }
}

Poi puoi chiedere in linguaggio naturale: «Cerca su Xiaohongshu i post sul cibo degli hawker di Singapore degli ultimi 7 giorni. Tieni quelli con più di 20 commenti e recupera una pagina di commenti per ciascuno. Elenca i piatti di cui la gente si lamenta». Le pagine delle azioni e il playground sono su API per i dati di Xiaohongshu e ricerca. I controlli per la configurazione MCP sono in configurazione MCP remota e gli strumenti per Xiaohongshu sono elencati su Xiaohongshu MCP.

Errori, risultati vuoti e limiti di frequenza delle richieste: cosa è gratuito

Con i prezzi a chiamata, la paura più grande è pagare per niente. Abbiamo fatto fallire di proposito tre richieste (un risultato vuoto, un parametro errato e una chiave mancante). Altre quattro richieste hanno raggiunto il limite di frequenza delle richieste (429). Nessuna delle sette è stata addebitata:

Il risultato vuoto ha richiesto 29 secondi. La risposta riporta count 0 e reason empty_result_refunded, e non è stato addebitato nulla. L'errore 422 elenca i valori consentiti, e questo aiuta quando è un modello AI a chiamare l'API.

Il modello legge did_you_mean e corregge la richiesta da solo.

Il limite di frequenza delle richieste vale per account e tutte le chiavi dell'account lo condividono, quindi aggiungere chiavi non dà più margine. Il limite dell'account dipende dall'importo totale che hai ricaricato (prezzi).

Le quattro risposte 429 non erano previste. La nostra chiave di test aveva un proprio limite di 10 chiamate al minuto. Dalle 00:14:59 alle 00:15:48 noi avevamo inviato solo 4 chiamate, quindi altri test stavano usando la stessa chiave nello stesso momento.

Ogni 429 indicava «Nothing was charged» e un retry_after da 5 a 17 secondi. Abbiamo inviato di nuovo le quattro richieste da 77 a 147 secondi dopo e tutte e quattro sono andate a buon fine al normale prezzo di $0,005556. In un job pianificato, attendi il retry_after, fai un nuovo tentativo e prevedi tempo di coda in ogni esecuzione. Per un metodo completo per riconciliare addebiti e rimborsi, vedi riconciliazione dei rimborsi per errori.

Prezzi dell'API di Xiaohongshu: 10 volte TikTok, quindi prevedi un budget separato

Saremo diretti: nel nostro catalogo, Xiaohongshu è la piattaforma social più costosa. Abbiamo preso il prezzo mediano di tutte le azioni disponibili su ogni piattaforma. Xiaohongshu costa $0,005556 per chiamata.

TikTok, YouTube, Instagram, Bilibili e Reddit costano $0,000556, esattamente un decimo. Douyin, Kuaishou, Weibo, Zhihu e X costano $0,000806, quindi Xiaohongshu costa 6,9 volte tanto. Taobao e JD costano $0,001389, quindi Xiaohongshu costa 4 volte tanto. Solo Amazon è leggermente più cara, con una mediana di $0,006875.

Il prezzo di catalogo di Xiaohongshu è da 4 a 10 volte quello delle altre piattaforme. La pagina dei prezzi riporta i valori aggiornati. In termini di budget, con $10 al mese compri circa 1.800 chiamate Xiaohongshu a $0,005556, e circa 18.000 chiamate alla mediana di TikTok di $0,000556.

Per te significa che, con lo stesso budget, ottieni circa un decimo delle richieste Xiaohongshu rispetto a quelle TikTok. Se un progetto copre entrambe le piattaforme, non usare un unico prezzo unitario per tutte e due. La pagina API per i dati di TikTok indica il suo prezzo. Significa anche che la prossima sezione, su come fare meno chiamate, qui conta più che sulle altre piattaforme.

Come fare meno chiamate: cinque abitudini e un conto mensile

Primo, usa gli elenchi prima dei dettagli. La ricerca e i post di un utente restituiscono 20 righe per pagina con titolo, estratto, like, salvataggi, numero di commenti, data e link. Per la maggior parte degli ordinamenti e dei filtri non serve altro.

Chiama xiaohongshu/note solo per la regione IP, i tag degli argomenti o il testo completo. Ogni riga di dettaglio costa 20 volte una riga di elenco. Secondo, controlla il numero di commenti prima di scaricarli. Nel nostro campione di 40 post la mediana dei commenti era 14, e solo 18 post ne avevano 20 o più.

Se scarichi i commenti di un post che ne ha 0, ottieni un risultato vuoto. È gratuito, ma occupa comunque uno slot del tuo limite di frequenza delle richieste. Terzo, usa i filtri temporali invece di riscaricare tutto. Un job giornaliero può impostare sort su newest e date_range su last_24_hours o last_7_days, ed elaborare solo i post nuovi.

Quarto, apri i thread di risposte solo quando serve. sub_comment_count ti dice già quante risposte ha ogni commento, quindi espandi solo quelli più attivi. Quinto, esegui il job solo con la frequenza che serve al business. Molti report sui concorrenti funzionano bene una volta a settimana.

La tabella usa il prezzo di catalogo di $0,005556. La quota di post con 20 o più commenti, 18 su 40, deriva dal nostro campione. È una stima, non una fattura.

Con le tue parole chiave la quota sarà diversa. Lo stesso monitoraggio scende da $70,01 a $4,44 al mese, cioè 15,8 volte meno. Il risparmio viene dal minor numero di chiamate, non da un prezzo unitario più basso. Qui il prezzo per chiamata aiuta: ogni chiamata è visibile, quindi puoi calcolare in anticipo quanto fa risparmiare ogni taglio.

Ecco la seconda abitudine nel dettaglio, con gli stessi 40 post sulla crema solare della nostra ricerca. In totale avevano 1.177 commenti. Undici post avevano 0 commenti, 18 ne avevano 20 o più e il più commentato ne aveva 231. La tabella usa il prezzo di catalogo di $0,005556 per pagina e 15 commenti per pagina:

L'ultima riga corrisponde a $0,444 per 1.000 commenti. È un valore superiore a $0,370 per una prima pagina, perché l'ultima pagina di un post spesso non è piena.

Quindi decidi prima se ti serve davvero ogni commento. Per classificare le opinioni, spesso bastano i primi 15 commenti di ogni post. Scarica tutte le pagine solo quando ti serve una quota calcolata su tutti i commenti, come la quota di commenti in cui viene citato un marchio. Puoi stimare un singolo post allo stesso modo. Il post con 232 commenti della nostra chiamata di dettaglio richiede 16 pagine, cioè $0,0889.

Le risposte funzionano allo stesso modo. I 15 commenti principali di una pagina indicavano 53 risposte, e ogni commento conteneva già 1 risposta inline. Per aprire tutte le altre risposte con xiaohongshu/sub_comments, a 10 righe per pagina, servono 14 chiamate, cioè $0,0778. Se apri solo i 4 commenti con 5 o più risposte, servono 4 chiamate, cioè $0,0222. È oltre il 70% in meno e mantieni i thread più attivi.

Infine, pensa al tempo. La nostra chiave di test consente 10 chiamate al minuto. A questa velocità, il piano giornaliero con i commenti su ogni post richiede 420 chiamate al giorno, cioè 42 minuti in coda. Il piano settimanale con i commenti solo sui post più attivi richiede 200 chiamate per esecuzione, cioè 20 minuti. I limiti dell'account dipendono dal totale che hai ricaricato, quindi controlla la pagina dei prezzi. Con qualsiasi limite, meno chiamate significano anche meno tempo in coda e meno errori dovuti al limite di frequenza delle richieste.

Come confrontare i prezzi di terze parti: una formula, sei domande

Molti servizi di terze parti fanno pagare per richiesta e scrivono i prezzi in molti modi. Alcuni addebitano per chiamata, altri per riga, altri per credito. Alcuni aggiungono un canone mensile o una quota di attivazione. Per confrontarli usa una sola formula. Prezzo per 1.000 righe = prezzo per richiesta ÷ righe effettivamente restituite per richiesta × 1.000.

Ecco un esempio inventato. Un servizio che addebita $0,01 per chiamata e restituisce 10 righe costa $1,00 per 1.000 righe. Con gli stessi $0,01 e 20 righe costa $0,50. Quindi il solo “prezzo per chiamata” dice poco. Chiedi quante righe restituisce ogni pagina o, meglio ancora, esegui una chiamata e contale. Con questa formula, la nostra ricerca Xiaohongshu costa $0,278 per 1.000 post e i commenti costano $0,370 per 1.000.

Le righe due, tre e quattro sono quelle che si tende a saltare. Con parole chiave rare e client AI che a volte inviano un parametro errato, il costo degli errori entra nel tuo conto mensile. Nel nostro test, le sette richieste che non hanno restituito dati (tre errori pianificati e quattro blocchi per limite di frequenza delle richieste) sono costate tutte $0. Fai domande su questi punti, poi esegui tu stesso una chiamata e conta le righe. Prezzi e regole sono nella pagina dei prezzi.

Nozioni di base sulla conformità: leggi, termini della piattaforma e buone pratiche per chi usa i dati

Questa non è una consulenza legale. Elenchiamo i punti principali della legge e dei termini della piattaforma. Per il tuo caso specifico, chiedi a un avvocato. In Cina tre norme riguardano direttamente i dati di Xiaohongshu.

L'articolo 27 della Legge sulla protezione delle informazioni personali riguarda le informazioni personali pubbliche. Ne consente il trattamento “entro un ambito ragionevole” quando è la persona stessa ad averle rese pubbliche o quando sono già pubbliche in modo lecito. Ciò non vale se la persona si oppone chiaramente. Serve il consenso quando il trattamento ha un effetto rilevante sulla persona (Legge sulla protezione delle informazioni personali).

L'articolo 18 del Regolamento sulla gestione della sicurezza dei dati di rete riguarda gli strumenti automatizzati che accedono ai dati di rete o li raccolgono. Chi usa uno strumento del genere deve valutarne l'effetto sul servizio di rete. Non deve introdursi in altre reti né disturbare il normale funzionamento del servizio (testo del regolamento). Il regolamento è in vigore dal 1° gennaio 2025 (Ministero della Giustizia).

La Legge contro la concorrenza sleale, rivista nel 2025, aggiunge l'articolo 13, comma 3. Stabilisce che un'impresa non deve usare frodi o coercizione per ottenere o usare dati detenuti lecitamente da un'altra impresa. Non deve neppure aggirare o violare misure tecniche di protezione per farlo. La legge rivista è entrata in vigore il 15 ottobre 2025 (Legge contro la concorrenza sleale, 2025).

Si applicano anche due insiemi di termini della piattaforma. Il contratto utente di Xiaohongshu è stato aggiornato il 23 marzo 2026. Le sezioni 3.4 e 4.1 limitano la lettura, il conteggio e l'uso commerciale dei contenuti della piattaforma senza autorizzazione scritta. Limitano anche lo scraping e i download simulati.

La sezione 2.3 limita inoltre la possibilità di prestare l'account ad altri (contratto utente). Dal 9 giugno 2026 gli utenti fuori dalla Cina continentale seguono i termini di RedNote. Anche questi termini limitano l'estrazione automatizzata dei dati (Termini di servizio di RedNote). Chiedi a un avvocato se il tuo uso rientra in questi limiti.

In Cina i tribunali hanno riconosciuto risarcimenti in casi di raccolta e rivendita su larga scala di dati delle piattaforme senza autorizzazione. In genere i tribunali si pongono quattro domande. Chi ha raccolto i dati ha aggirato o violato misure tecniche di protezione? I singoli record sono stati aggregati in una raccolta di dati su larga scala destinata alla rivendita? Sono stati toccati dati personali o funzioni private? Il normale funzionamento della piattaforma ne ha risentito?

Qualunque strada tu scelga, dovresti almeno adottare queste pratiche quando usi i dati:

• Usa i dati solo per uno scopo lecito e chiaro, come il brand listening o la ricerca di prodotto. Metti per iscritto lo scopo e verifica di nuovo prima di cambiarlo.
• Rispetta i termini della piattaforma e la legge del luogo in cui operi. Chiedi a un avvocato prima di qualsiasi uso soggetto a limitazioni in base a tali termini, come la rivendita commerciale o il download in blocco dei contenuti.
• Riduci al minimo i dati personali. Considera dati personali i nickname, gli avatar e le regioni IP nei commenti. Non conservare campi che la tua analisi non usa. Quando puoi, conserva i totali invece delle singole righe. Metti per iscritto per quanto tempo conservi i dati e perché.
• Non rivendere dati grezzi. Ai clienti consegna risultati e tabelle di sintesi, non pacchetti di righe grezze, e non pubblicare righe grezze.
• Raccogli solo ciò che serve alla tua analisi ed elimina i vecchi dati grezzi secondo una pianificazione.
• Non accedere a messaggi privati, account privati o altri contenuti non pubblici. Non usare i dati per inviare messaggi in massa agli utenti.

Queste pratiche vanno nella stessa direzione delle abitudini della sezione “Come fare meno chiamate”. Quando raccogli solo i dati che servono alla tua analisi, paghi meno e hai anche meno dati da conservare e proteggere.

Quale strada scegliere in base al lavoro da fare

Se sviluppi la tua app e vuoi l'opzione “Accedi con Xiaohongshu”, usa la piattaforma account e richiedi basic_info. Crea l'app, imposta l'indirizzo di callback e attendi da 1 a 3 giorni lavorativi per la revisione. Se vendi su Xiaohongshu e vuoi ordini e post-vendita nel tuo ERP, usa la piattaforma aperta per l'e-commerce. Scegli il ruolo per lo sviluppo in proprio se hai sviluppatori, oppure trova un fornitore nel marketplace dei servizi. Se acquisti pubblicità e vuoi report in blocco, chiedi al tuo sales manager della piattaforma di attivare la Marketing API. Nessuno di questi tre casi richiede una terza parte, e in nessuno dovresti usarla.

Se il tuo lavoro consiste nel monitorare altri soggetti, oggi i canali ufficiali non aiutano. Rientrano in questi casi il numero di post e l'engagement dei concorrenti, le opinioni degli utenti su un argomento, i consigli sui prodotti e l'immagine di un marchio sulla piattaforma. Puoi scegliere uno script o un'API di terze parti. Per lavori piccoli, occasionali o svolti a scopo di apprendimento basta uno script open source. Usa un account che puoi permetterti di perdere e leggi la licenza. Per un job giornaliero, un progetto da consegnare a un cliente o un client AI che accede autonomamente ai dati, è più semplice usare un'API con tariffazione per chiamata.

Tieni basso il volume con le abitudini della sezione “Come fare meno chiamate” e segui le pratiche della sezione sulla conformità. Questo vale anche per i marchi stranieri. Un report di Inside Retail Asia del 12 ottobre 2026 riporta che le persone usano l'app come un motore di ricerca (Inside Retail Asia).

Per questo la ricerca per parole chiave di solito dice a un marchio più del numero di follower. Due articoli correlati approfondiscono l'argomento. Esportazione dei dati di Xiaohongshu e analisi degli snapshot mostra come salvare i dati di ricerca e dei commenti come snapshot. Commenti di Xiaohongshu in blocco descrive tutti i passaggi per i commenti in batch.

Notizie del settore, ottobre e novembre 2026

• 3 novembre 2026: il giorno prima del nostro campione, MediaCrawler, xiaohongshu-mcp e XiaohongshuSkills avevano tutti ricevuto nuovi commit. Negli ultimi 30 giorni avevano totalizzato rispettivamente 11, 35 e 32 commit. ReaJason/xhs era ancora fermo al 1° luglio 2025 (GitHub API, consultata alle 00:19:50 ora di Singapore del 4 novembre 2026). Cosa significa: gli strumenti ancora attivi cambiano di continuo, quindi devi seguirne gli aggiornamenti. Quelli non più aggiornati non sono adatti a un job pianificato.
• Dal 21 al 23 ottobre 2026: nella stessa settimana sono state aperte per xiaohongshu-mcp issue su “impossibile accedere” e “ricerca limitata”. Il 1° novembre il maintainer ha eseguito il merge delle correzioni per l'attesa della ricerca e per il flusso di pubblicazione. Il 3 novembre è seguita una correzione per la pulizia del browser dopo un accesso non riuscito (cronologia dei commit). Cosa significa: gli strumenti che dipendono da un login richiedono interventi ogni poche settimane, quindi un job pianificato deve inviare una notifica in caso di errore.
• 17 ottobre 2026: le pagine web del sito hanno cambiato il formato dei dati lato server. XHS-Downloader, un downloader con più di 13.000 stelle, ha smesso di eseguire il parsing dei post fino alla pubblicazione di una correzione (issue 497). Cosa significa: una modifica alle pagine in un normale giorno feriale può bloccare tutti gli script che leggono quella pagina, quindi metti in conto il tempo necessario per intervenire.
• 19 agosto 2026: il riferimento API della piattaforma account è stato aggiornato e resta aperto solo basic_info (riferimento API). Cosa significa: non contare sulla disponibilità a breve di un'API ufficiale per leggere i post.

Per iniziare: da una chiamata di test a un job settimanale

Primo passo: registrati su EveryInfra e crea una chiave API. Non c'è un canone mensile e il saldo che ricarichi non scade. I passaggi sono nella guida rapida. Secondo passo: consulta il catalogo gratuito. Poi prova una chiamata dalla pagina di un'azione. Le pagine per i post sono ricerca, dettaglio del post e post dell'utente.

Le pagine per i commenti sono commenti, commenti in batch e risposte. Per i negozi usa ricerca prodotti. Terzo passo: guarda charged_usd e il numero di righe nella risposta, e calcola il tuo prezzo per 1.000 righe con “addebito ÷ righe × 1.000”. Poi usa la tabella della sezione “Come fare meno chiamate” per stimare un mese. Quarto passo: aggiungi il blocco MCP al tuo client AI e chiedigli di eseguire le tue parole chiave una volta a settimana. Le altre piattaforme sono nel marketplace dei dati e lo stato del servizio è nella pagina di stato.

FAQ

Xiaohongshu ha un'API ufficiale?

Questa domanda nasce da suggerimenti di ricerca come “xiaohongshu api documentation” e “rednote api documentation”. Sì, ma solo per le tue risorse. La piattaforma account apre solo basic_info (nickname, avatar, genere e regione). La piattaforma e-commerce consente ad aziende e fornitori di leggere ordini e prodotti dei negozi che li autorizzano. L'API per la pubblicità fornisce agli inserzionisti i propri report (elenco degli scope, autorizzazione del negozio). Non esiste un'API ufficiale che legga post o commenti pubblici di altre persone, e read_notes è ancora “in programma”.

Come ottengo una chiave API di Xiaohongshu?

Questa domanda nasce dai suggerimenti “xiaohongshu api key” e “rednote api key”. Non esiste un'unica “chiave API” ufficiale. Sulla piattaforma account crei un'app e ottieni un app id e un app secret. La revisione richiede da 1 a 3 giorni lavorativi circa (guida rapida).

Sulla piattaforma e-commerce un'azienda verificata ottiene un appId e un appSecret, e poi l'account principale del negozio deve autorizzare l'app. Per l'API per la pubblicità, è un sales manager ad avviare la registrazione. Se ti serve una chiave che legga i post pubblici, si tratta di una chiave di un servizio di terze parti. Con EveryInfra la crei nella console dopo la registrazione.

Posso usare in un prodotto commerciale gli scraper per Xiaohongshu presi da GitHub?

Questa domanda nasce dal suggerimento “xiaohongshu api github”. Controlla la licenza. Nel nostro campione di nove progetti, la licenza di MediaCrawler consente solo l'apprendimento non commerciale e vieta il crawling su larga scala (licenza).

Spider_XHS e xiaohongshu-cli non dichiarano alcuna licenza, quindi gli autori mantengono tutti i diritti. xiaohongshu-mcp usa Apache-2.0 e XHS-Downloader usa GPL-3.0. Una licenza copre solo il codice. Non copre i dati che raccogli con quel codice. A quei dati si applicano comunque i termini della piattaforma e la legge.

Un account RedNote funziona con gli script per Xiaohongshu?

Questa domanda nasce dai suggerimenti “rednote xiaohongshu api” e “rednote api github”. Spesso no. L'issue #579 di xiaohongshu-mcp spiega il cambiamento.

Gli account registrati con un numero di telefono non cinese dopo l'8 dicembre 2025 sono account RedNote. La loro sessione web passa a rednote.com e il dominio dei cookie cambia. Gli script che leggono solo i cookie di xiaohongshu.com segnalano quindi “non connesso”. Gli utenti RedNote seguono anche termini separati, entrati in vigore il 9 giugno 2026, che vietano l'estrazione automatizzata (termini di RedNote).

Come vengono di solito fissati i prezzi delle API per Xiaohongshu?

Questa domanda nasce dai suggerimenti “xiaohongshu api pricing” e “xiaohongshu api pricing reddit”. I canali ufficiali non indicano alcun costo per l'API in sé. I servizi di terze parti di solito addebitano per richiesta, per riga o per credito, e alcuni aggiungono un canone mensile. Prima di confrontarli, converti ogni prezzo nel prezzo per 1.000 righe con la formula della sezione sul confronto dei prezzi. Con EveryInfra, 16 delle 17 azioni per Xiaohongshu costano $0,005556 per chiamata. Nel nostro test questo equivaleva a $0,278 per 1.000 post di ricerca e $0,370 per 1.000 commenti (catalogo).

Riferimenti

1. “Developer portal home”, piattaforma aperta di Xiaohongshu, consultato il 2026-11-04. https://openaccount.xiaohongshu.com/
2. “Scope list”, piattaforma aperta di Xiaohongshu, ultimo aggiornamento 2026-03-29, screenshot del 2026-11-04. https://openaccount.xiaohongshu.com/docs/scope
3. “API reference”, piattaforma aperta di Xiaohongshu, ultimo aggiornamento 2026-08-19. https://openaccount.xiaohongshu.com/docs/api-reference
4. “Quick start”, piattaforma aperta di Xiaohongshu, ultimo aggiornamento 2026-03-29. https://openaccount.xiaohongshu.com/docs/quick-start
5. “Authorization flow for software vendors”, piattaforma aperta per l'e-commerce di Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/38
6. “Signature method”, piattaforma aperta per l'e-commerce di Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/39
7. “Developer document index”, piattaforma aperta per l'e-commerce di Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/4
8. “Developer role guide”, mirror di terze parti della documentazione della piattaforma e-commerce. https://xiaohongshu.apifox.cn/doc-2811119
9. “Marketing API getting started guide”, piattaforma pubblicitaria di Xiaohongshu, aggiornato il 2024-01-03. https://ad.xiaohongshu.com/openApiDoc?categoryId=761&articleId=3047
10. “Share open platform home”, Xiaohongshu. https://agora.xiaohongshu.com/index
11. Post del forum sulla piattaforma di condivisione sospesa, V2EX, 2025-11-06. https://global.v2ex.co/t/1170874
12. “Mini program open platform”, Xiaohongshu. https://miniapp.xiaohongshu.com/
13. “Xiaohongshu user agreement”, aggiornato il 2026-03-23. https://agree.xiaohongshu.com/h5/terms/ZXXY20220331001/-1
14. “RedNote Terms of Service”, in vigore dal 2026-06-09. https://agree.xiaohongshu.com/h5/terms/ZXXY20251205003/-1
15. NanmiCoder/MediaCrawler, GitHub, consultato il 2026-11-04. https://github.com/NanmiCoder/MediaCrawler
16. “MediaCrawler NON-COMMERCIAL LEARNING LICENSE 1.1”, GitHub. https://github.com/NanmiCoder/MediaCrawler/blob/main/LICENSE
17. «xpzouying/xiaohongshu-mcp», GitHub. https://github.com/xpzouying/xiaohongshu-mcp
18. Cronologia dei commit di xiaohongshu-mcp, GitHub. https://github.com/xpzouying/xiaohongshu-mcp/commits/main
19. Issue 880 di xiaohongshu-mcp, “cannot log in”, 2026-10-23. https://github.com/xpzouying/xiaohongshu-mcp/issues/880
20. Issue 877 di xiaohongshu-mcp, “search is limited”, 2026-10-21. https://github.com/xpzouying/xiaohongshu-mcp/issues/877
21. Issue 878 di xiaohongshu-mcp, “does the platform allow this tool”, 2026-10-22. https://github.com/xpzouying/xiaohongshu-mcp/issues/878
22. Issue 579 di xiaohongshu-mcp, “support for rednote.com users”, 2026-03-13. https://github.com/xpzouying/xiaohongshu-mcp/issues/579
23. «JoeanAmier/XHS-Downloader», GitHub. https://github.com/JoeanAmier/XHS-Downloader
24. Issue 497 di XHS-Downloader, “server-side data parse failure”, 2026-10-17. https://github.com/JoeanAmier/XHS-Downloader/issues/497
25. Issue 479 di XHS-Downloader, “slower crawl setting”, 2026-09-15. https://github.com/JoeanAmier/XHS-Downloader/issues/479
26. «cv-cat/Spider_XHS», GitHub. https://github.com/cv-cat/Spider_XHS
27. Issue 191 di Spider_XHS, “Cookie is invalid or expired”, 2026-10-10. https://github.com/cv-cat/Spider_XHS/issues/191
28. «jackwener/xiaohongshu-cli», GitHub. https://github.com/jackwener/xiaohongshu-cli
29. Issue 82 di xiaohongshu-cli, “forced login every 7 days”, 2026-08-17. https://github.com/jackwener/xiaohongshu-cli/issues/82
30. «ReaJason/xhs», GitHub. https://github.com/ReaJason/xhs
31. «white0dew/XiaohongshuSkills», GitHub. https://github.com/white0dew/XiaohongshuSkills
32. «autoclaw-cc/xiaohongshu-skills», GitHub. https://github.com/autoclaw-cc/xiaohongshu-skills
33. «Jamailar/Beav», GitHub. https://github.com/Jamailar/Beav
34. Cloxl/xhshow, libreria per la firma delle richieste, GitHub. https://github.com/Cloxl/xhshow
35. “List repository issues”, documentazione della GitHub REST API. https://docs.github.com/en/rest/issues/issues#list-repository-issues
36. “Licensing a repository”, documentazione di GitHub. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
37. “Personal Information Protection Law of the PRC”, Amministrazione del ciberspazio della Cina. https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm
38. “Network Data Security Management Regulations” (decreto del Consiglio di Stato n. 790), copia sul sito del Ministero dell'Ecologia e dell'Ambiente. https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml
39. “Release of the Network Data Security Management Regulations”, Ministero della Giustizia, 2024-09-30. https://www.moj.gov.cn/pub/sfbgw/gwxw/xwyw/202409/t20240930_507076.html
40. “Anti-Unfair Competition Law of the PRC”, revisione 2025, Amministrazione nazionale cinese per la proprietà intellettuale. https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html
41. “Less shouting, more answering: How brands win on XHS”, Inside Retail Asia, 2026-10-12. https://insideretail.asia/2026/10/12/less-shouting-more-answering-how-brands-win-on-xhs/
42. Thread del forum V2EX t/1170609 (ne citiamo le risposte sugli endpoint delle pagine del marketplace dei creator), V2EX. https://www.v2ex.com/t/1170609
43. Catalogo dei dati social di EveryInfra (consultabile gratuitamente), consultato il 2026-11-04 alle 00:13 ora di Singapore. https://api.everyinfra.com/api/v1/social/catalog
44. «Model Context Protocol specification 2025-06-18». https://modelcontextprotocol.io/specification/2025-06-18