API di Xiaohongshu

Cosa significano i parametri search di API di Xiaohongshu?

Trova note di Xiaohongshu su un argomento, 20 per pagina. Ottieni titolo, estratto del testo, numero di like, salvataggi, commenti e condivisioni, autore e data di pubblicazione. Restringi per tipo di contenuto, ordinamento e intervallo di date. Per la pagina successiva, rimanda next_page_token come page_token. Il testo della ricerca è un estratto, non la nota completa.

keywordObbligatorio

Indica la stringa di ricerca per il contenuto delle note Xiaohongshu (ad es. "sensitive skin sunscreen") nell'azione search. Cerca nel testo delle note, non negli ID utente.

content_typeFacoltativo

Filtra le note restituite per tipo di contenuto, ad es. immagini/testo o video. Usa i valori consentiti indicati per l'azione corrente.

Valori ammessi:allimagevideo

Xiaohongshu: i punti di accesso alle note con immagini e testo e alle note video — La documentazione pubblica sui deeplink di Xiaohongshu elenca separatamente le note con immagini e testo, le note video e le pagine dei commenti delle note. Questo riferimento cita solo le distinzioni tra tipi di contenuto; i parametri di reindirizzamento dell'app presenti nella documentazione non possono essere passati direttamente a questo endpoint. · Verificato 2026-09-04

date_rangeFacoltativo

Filtra le note per data di pubblicazione: any_time (nessun limite, come ometterlo), last_24_hours (ultime 24 ore), last_7_days (ultimi 7 giorni), last_30_days (ultimo mese), last_6_months (ultimi sei mesi) o last_1_year (ultimo anno). Con last_30_days e last_1_year una pagina può contenere meno di 20 note, e una pagina vuota non viene addebitata; aggiungi sort=newest per pagine più piene. Questi due valori funzionano solo nelle chiamate sincrone. Mantieni lo stesso valore durante la paginazione.

Valori ammessi:any_timelast_1_yearlast_24_hourslast_30_dayslast_6_monthslast_7_days

page_tokenFacoltativo

Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.

sortFacoltativo

Imposta l'ordine degli elenchi di note nell'azione search: relevance, newest, most_liked, most_commented o most_collected. Usa solo i valori consentiti indicati per l'azione.

Valori ammessi:most_collectedmost_commentedmost_likednewestrelevance

Cosa significano i parametri profile di API di Xiaohongshu?

Cerca un account Xiaohongshu. Ottieni nickname, ID Xiaohongshu, bio, località IP, verifica e il numero esatto di follower, account seguiti, post, like e salvataggi. Passa l'ID di un link /user/profile/, il link stesso o l'author_id di chi ha commentato. I conteggi non visibili vengono restituiti come null, non come zero.

user_idObbligatorio

Indica l'ID utente Xiaohongshu (l'identificativo dopo /user/profile/ nell'URL) o l'URL completo del profilo per le azioni profile e user_posts. Funziona anche l'author_id restituito dalle azioni sui commenti. Serve a recuperare i dettagli del profilo o le note pubblicate; non accetta i nomi visualizzati degli utenti.

Cosa significano i parametri user_posts di API di Xiaohongshu?

Elenca le note pubblicate da un creator di Xiaohongshu, 20 per pagina. Le note in evidenza vengono prima, poi le altre dalla più recente alla meno recente. Ottieni estratto, conteggi e link ai video. Usa page_token per altri risultati. Qui i link non includono un token di accesso e il testo è un estratto. Chiama note per un link apribile nel browser e il testo completo.

user_idObbligatorio

Indica l'ID utente Xiaohongshu (l'identificativo dopo /user/profile/ nell'URL) o l'URL completo del profilo per le azioni profile e user_posts. Funziona anche l'author_id restituito dalle azioni sui commenti. Serve a recuperare i dettagli del profilo o le note pubblicate; non accetta i nomi visualizzati degli utenti.

page_tokenFacoltativo

Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.

Cosa significano i parametri note di API di Xiaohongshu?

Leggi una nota di Xiaohongshu per intero. Ottieni il testo, tutte le immagini in ordine, i topic, gli utenti menzionati, i conteggi di interazione e la località IP. Le coordinate vengono restituite quando le immagini le contengono. Passa il link completo della nota con xsec_token intatto. Il link di riproduzione del video e i commenti richiedono chiamate separate a video e comments.

urlObbligatorio

Indica l'URL completo della nota Xiaohongshu, nel formato /explore/<note_id> o /discovery/item/<note_id>. Usa URL di ricerca recenti che mantengono parametri di query come xsec_token. L'azione sub_comments richiede sia questo url sia un comment_id valido.

Cosa significano i parametri video di API di Xiaohongshu?

Recupera il link di riproduzione e la durata di una nota video di Xiaohongshu dallo stesso URL accettato da note. Il link firmato scade, quindi scaricalo a breve. Le note con immagini restituiscono un risultato vuoto e vengono rimborsate.

urlObbligatorio

Indica l'URL completo della nota Xiaohongshu, nel formato /explore/<note_id> o /discovery/item/<note_id>. Usa URL di ricerca recenti che mantengono parametri di query come xsec_token. L'azione sub_comments richiede sia questo url sia un comment_id valido.

Cosa significano i parametri comments di API di Xiaohongshu?

Recupera i commenti di primo livello di una nota di Xiaohongshu, 15 per pagina, con testo, like, località IP, autore del commento, numero di risposte e indicatori di autore o account AI. Ordinali con sort, scorri le pagine con page_token e leggi le risposte vere e proprie tramite sub_comments.

urlObbligatorio

Indica l'URL completo della nota Xiaohongshu, nel formato /explore/<note_id> o /discovery/item/<note_id>. Usa URL di ricerca recenti che mantengono parametri di query come xsec_token. L'azione sub_comments richiede sia questo url sia un comment_id valido.

page_tokenFacoltativo

Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.

sortFacoltativo

Ordine dei commenti: default segue l'ordine della piattaforma (equivale a ometterlo), newest mette per primi i commenti più recenti e most_liked quelli con più like. Mantieni lo stesso valore durante la paginazione; con un valore diverso, il next_page_token precedente non è più valido. default è l'ordine consigliato dalla piattaforma e viene ricalcolato a ogni richiesta, quindi quando l'ordinamento cambia la paginazione salta o ripete alcuni commenti; newest ordina per data e pagina in modo coerente, anche se per alcune note la piattaforma restituisce solo la parte più recente. Una pagina senza next_page_token significa solo che la piattaforma non ha segnalato una pagina successiva, non che sono stati restituiti tutti i commenti. Con default, scorrere più volte tutte le pagine dall'inizio e unire i risultati per id del commento permette di recuperare una parte di quelli mancati.

Valori ammessi:defaultmost_likednewest

Cosa significano i parametri comments_batch di API di Xiaohongshu?

Raccogli i commenti di 1-20 note di Xiaohongshu in una sola chiamata. Ogni riga include note_id e note_url, così le discussioni restano separate. Ogni link deve contenere un ID nota e un xsec_token validi. Una nota non riuscita viene segnalata come mancata, non come nota con zero commenti.

urlsObbligatorio

Indica un array da 1 a 20 URL di note Xiaohongshu per l'azione comments_batch. Ogni URL deve contenere un ID nota valido e un xsec_token. L'addebito è per nota di destinazione; se alcune note non riescono, controlla i campi della risposta parziali o mancanti invece di presumere che non ci siano commenti.

sortFacoltativo

Ordine dei commenti per ogni nota della richiesta: default segue l'ordine della piattaforma (equivale a ometterlo), newest mostra per primi i commenti più recenti e most_liked quelli con più Mi piace.

Valori ammessi:defaultmost_likednewest

Cosa significano i parametri sub_comments di API di Xiaohongshu?

Leggi le risposte a un commento su una nota di Xiaohongshu, 10 per pagina. Ottieni testo, like, località IP e a chi risponde ciascuna risposta. Passa il link della nota con un comment_id preso dai risultati dei commenti. Usa reply_to_id per ricostruire la discussione.

urlObbligatorio

Indica l'URL completo della nota Xiaohongshu, nel formato /explore/<note_id> o /discovery/item/<note_id>. Usa URL di ricerca recenti che mantengono parametri di query come xsec_token. L'azione sub_comments richiede sia questo url sia un comment_id valido.

comment_idObbligatorio

Indica l'ID del commento padre di cui recuperare le risposte nell'azione sub_comments. Ricava questo ID dalla risposta di comments per la stessa nota e abbinalo all'url corrispondente. Non è un ID nota né un ID utente.

page_tokenFacoltativo

Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.

Cosa significano i parametri search_users di API di Xiaohongshu?

Trova creator e account di brand su Xiaohongshu per parola chiave, 20 per pagina. Ottieni nickname, ID Xiaohongshu, numero di follower e tipo di verifica. Filtra per follower_range o user_type. Il numero di follower approssima le cifre arrotondate dell'elenco, quindi chiama profile per i valori esatti.

keywordObbligatorio

Una keyword per trovare account, ad esempio coffee, il nome di un brand o un argomento. Restituisce utenti (creator e account di brand), non note.

follower_rangeFacoltativo

Filtra gli account in search_users per numero di follower: under_100, 100_to_1k, 1k_to_10k, 10k_to_100k o over_100k. Omettilo per non avere limiti.

Valori ammessi:100_to_1k10k_to_100k1k_to_10kover_100kunder_100

page_tokenFacoltativo

Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.

user_typeFacoltativo

Filtra gli account in search_users per tipo: general (utente normale), verified_individual (persona verificata) o business (azienda verificata). Omettilo per non avere limiti.

Valori ammessi:businessgeneralverified_individual

Cosa significano i parametri hashtag di API di Xiaohongshu?

Sfoglia le note di una pagina topic di Xiaohongshu, dalle più recenti o dalle più popolari. Ottieni testo completo, tutte le immagini, conteggi di interazione e dettagli dei video. Passa un topic_id di 24 caratteri o il link del topic. Le pagine contengono fino a 20 note e solo l'assenza di next_page_token indica la fine.

topic_idObbligatorio

L'ID della pagina dell'argomento per hashtag (24 caratteri), oppure un link a una pagina dell'argomento come https://www.xiaohongshu.com/page/topics/<ID>, un link all'argomento nell'app o un link breve di condivisione Xiaohongshu. I valori topics[].topic_id restituiti da note funzionano direttamente. Non è l'ID dell'oggetto tag di una nota né il nome dell'argomento.

page_tokenFacoltativo

Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.

sortFacoltativo

Ordine delle note dell'argomento: newest mostra per prime le più recenti (equivale a ometterlo) e popular mostra per prime le più popolari. Usa lo stesso valore durante la paginazione.

Valori ammessi:newestpopular

Cosa significano i parametri trending di API di Xiaohongshu?

Visualizza un campione delle note che Xiaohongshu sta consigliando in questo momento, fino a 30, con titolo, autore, immagine e indicatore video. La selezione cambia a ogni caricamento e la posizione nell'elenco non spiega l'algoritmo né costruisce uno storico.

Questa azione non ha parametri di business. Invia solo gli identificativi della piattaforma e dell'azione.

Cosa significano i parametri product_search di API di Xiaohongshu?

Cerca prodotti nello store di Xiaohongshu tramite keyword. Ogni prodotto include titolo, prezzo, prezzo di listino, valuta, unità vendute se la pagina le mostra, disponibilità, immagine e negozio. Una pagina contiene di solito 19 prodotti (osservati da 18 a 20); passa alle pagine successive con next_page_token. Si tratta di prodotti dello store, non di note, e ogni id funziona in product_detail.

keywordObbligatorio

Un termine di ricerca di prodotti nello store di Xiaohongshu, ad esempio sunscreen. Restituisce prodotti (SKU), non note; ogni id funziona come product_id in product_detail.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Una pagina contiene di solito 19 prodotti (osservati da 18 a 20) e corrisponde a una chiamata; lo store riordina i risultati, quindi pagine adiacenti possono avere alcuni prodotti in comune: deduplica per id. Usa un token entro 24 ore; l'ultima pagina non ha next_page_token.

Cosa significano i parametri product_detail di API di Xiaohongshu?

Leggi un prodotto dello store di Xiaohongshu tramite il suo ID di 24 caratteri o il link alla pagina del prodotto. Ottieni prezzo e prezzo di listino, categoria, variante, disponibilità, unità vendute (un valore minimo quando la pagina mostra una cifra arrotondata), immagini principali e di dettaglio, attributi del prodotto e, per il negozio, la valutazione se presente, le vendite totali, il numero di follower e l'account Xiaohongshu collegato.

product_idObbligatorio

L'ID prodotto di 24 caratteri preso dall'id di una riga di product_search, oppure un link al prodotto https://www.xiaohongshu.com/goods-detail/<ID>. Un ID non valido viene rifiutato prima di qualsiasi addebito.

Cosa significano i parametri reviews di API di Xiaohongshu?

Leggi le recensioni degli acquirenti di un prodotto dello store di Xiaohongshu tramite il suo product_id di 24 caratteri, in ordine predefinito o dalla più recente. Ogni recensione include testo completo, valutazione su 5 punti, valutazioni di servizio e consegna, voti di utilità, numero di risposte, foto dell'acquirente, tag della recensione, variante acquistata e data della recensione. ID, nomi e avatar di chi recensisce non vengono mai restituiti. Fino a 20 per pagina.

product_idObbligatorio

L'ID prodotto di 24 caratteri preso dall'id di una riga di product_search, oppure un link al prodotto https://www.xiaohongshu.com/goods-detail/<ID>. Un ID non valido viene rifiutato prima di qualsiasi addebito.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Una pagina contiene fino a 20 recensioni e corrisponde a una chiamata; l'ultima pagina non ha next_page_token.

sortFacoltativo

Ordine delle recensioni: default (l'ordinamento predefinito dello store, equivale a ometterlo) o newest (prima le più recenti). Usa lo stesso valore durante la paginazione.

Valori ammessi:defaultnewest

Cosa significano i parametri followers_list di API di Xiaohongshu?

Elenca i follower di un account Xiaohongshu tramite il suo user_id di 24 caratteri o il link al profilo. Ogni follower include user_id, nickname, avatar, link al profilo, numero di follower e numero di note. Una pagina contiene di solito 19-20 persone; passa alle pagine successive con next_page_token. Molti account nascondono l'elenco dei follower: in quel caso la chiamata non riesce e viene rimborsata.

user_idObbligatorio

L'utente di cui elencare i follower: lo user_id di 24 caratteri restituito da profile o search_users, oppure un link al profilo https://www.xiaohongshu.com/user/profile/<ID>. Molti account nascondono l'elenco dei follower; in quel caso la chiamata non va a buon fine e viene rimborsata.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Una pagina contiene di solito da 19 a 20 persone e corrisponde a una chiamata; l'ultima pagina non ha next_page_token.

Cosa significano i parametri note_location di API di Xiaohongshu?

Leggi il luogo taggato in una nota di Xiaohongshu, tramite il link della nota o un link di condivisione. Ottieni il testo della località così come appare, la città, il nome del luogo e gli ID del luogo. Una nota senza luogo taggato restituisce un risultato vuoto.

urlObbligatorio

Il link a una nota (/explore/<note ID> o /discovery/item/<note ID>) o un link di condivisione di Xiaohongshu. Serve solo l'ID della nota, non l'xsec_token; se il link ne contiene uno, il link della nota restituito lo conserva.

Cosa significano i parametri pgy_content_square di API di Xiaohongshu?

Leggi le classifiche dei contenuti popolari della content square di Pugongying, il marketplace di Xiaohongshu che mette in contatto brand e creator: note più popolari in assoluto, product seeding, promozione e-commerce, collaborazioni con i brand, lead generation e altro, su un periodo da 3 a 30 giorni, oppure cerca nella content square per parola chiave (senza classifiche né finestre temporali). Ogni nota riporta posizione, letture, like, salvataggi, commenti, un indicatore di annuncio e i follower dell'autore. 20 per pagina e al massimo 100 righe per classifica.

boardFacoltativo

Quale classifica della content square di Pugongying legge pgy_content_square: hot (popolari su Xiaohongshu, predefinita), product_seeding, ecommerce_promo, brand_collab, lead_gen, ecommerce_hot, seeding_direct o app_promo. Ignorato quando è impostato keyword.

Valori ammessi:app_promobrand_collabecommerce_hotecommerce_promohotlead_genproduct_seedingseeding_direct

keywordFacoltativo

Facoltativo: cerca le note della content square con questa parola, ad esempio coffee; omettilo per l'intera classifica. Una ricerca per parola chiave è ordinata per popolarità e non supporta classifiche né finestre temporali (board e time_window vengono ignorati), quindi possono comparire note dell'ultimo mese o due; le sue righe non hanno like_count, comment_count, video_url, duration_sec né author_avatar_url, e i loro link non contengono un token di accesso.

page_tokenFacoltativo

Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Ogni pagina contiene 20 note e corrisponde a una chiamata; una classifica contiene al massimo 100 note (5 pagine) e l'ultima pagina non ha next_page_token.

time_windowFacoltativo

Finestra temporale per pgy_content_square: 3d, 7d (predefinita), 14d o 30d. Ignorata quando è impostato keyword.

Valori ammessi:14d30d3d7d