API Xiaohongshu Dettagli del prodotto

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

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.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su xiaohongshu e action impostato su product_detail. Prezzo $5.56 per 1.000 richieste ($0.005556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Xiaohongshu Dettagli del prodotto di EveryInfra (xiaohongshu/product_detail).

Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su xiaohongshu e action su product_detail, e inserisci i parametri in params.
- Parametri obbligatori:
  - product_id: 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.
- Restituisce un oggetto. Campi principali: id, title, url (Il link del record su Xiaohongshu), price, original_price (Prezzo di listino del prodotto prima de…), currency, in_stock (Indica se il prodotto è attualmente dis…), category, sold_count (Unità vendute come le mostra la pagina…), variant_name (Nome della variante di questo SKU (prod…), image_urls, detail_image_urls (Immagini della sezione con i dettagli d…); 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu.
- Esempio di corpo della richiesta:
{
  "platform": "xiaohongshu",
  "action": "product_detail",
  "params": {
    "product_id": "6a4629ef7d09bf0001a45876"
  }
}
- Prezzo: $5.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.

Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.

Parametri della richiesta

Nome	Posizione	Tipo	Obbligatorio	Predefinito	Descrizione
`Authorization`	header	`string`	Sì	-	Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
`platform`	body	`string`	Sì	`xiaohongshu`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`product_detail`	Identificativo della funzionalità, valore fisso.
`product_id`	body.params	`string`	Sì	-	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.

Esempi di codice

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "xiaohongshu",
  "action": "product_detail",
  "params": {
    "product_id": "6a4629ef7d09bf0001a45876"
  }
}'

Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.

Esempio di risposta

json

{  "id": "req_…",  "platform": "xiaohongshu",  "action": "product_detail",  "results": {    "id": "6a4629ef7d09bf0001a45876",    "title": "SETFV · 美白补水隔离防晒乳SPF50 PA+++",    "url": "https://www.xiaohongshu.com/goods-detail/6a4629ef7d09bf0001a45876",    "price": 39.9,    "original_price": 39.9,    "currency": "CNY",    "in_stock": true,    "category": "防晒膏/防晒粉末",    "variant_name": "1盒",    "image_urls": [      "https://mall-i2.xhscdn.com/arkgoods/1040g0o0322efr2nfmu005noum8b083028qmmed0?imageView2/2/w/1440/format/heif/q/46&redImage/frame/0&ap=3&sc=STR_DTL",      "https://mall-i2.xhscdn.com/arkgoods/1040g0o032246gbu16u005noum8b08302hee4hqg?imageView2/2/w/1440/format/heif/q/46&redImage/frame/0&ap=3&sc=STR_DTL",      "https://mall-i2.xhscdn.com/arkgoods/1040g3no32246hsg674005noum8b08302sd2f8s8?imageView2/2/w/1440/format/heif/q/46&redImage/frame/0&ap=3&sc=STR_DTL"    ],    "detail_image_urls": [      "https://mall-i2.xhscdn.com/arkgoods/1040g0o032246i1qk6s005noum8b083022cef7pg?imageView2/2/w/1440/format/heif/q/46&redImage/frame/0&ap=3&sc=STR_DTL",      "https://mall-i2.xhscdn.com/arkgoods/1040g0o032246i1r2n2105noum8b083023hnphi0?imageView2/2/w/1440/format/heif/q/46&redImage/frame/0&ap=3&sc=STR_DTL",      "https://mall-i2.xhscdn.com/b/2f46a29a-0cf7-4fca-b679-91553cd4062a?imageView2/2/w/1440/format/heif/q/46&redImage/frame/0&ap=3&sc=STR_DTL"    ],    "attributes": [      {        "name": "是否为特殊用途化妆品",        "value": "是"      },      {        "name": "化妆品备案编号",        "value": "国妆特字G20211486"      }    ],    "shop_id": "698598ee6da47c00158754ee",    "shop_name": "SETFV黑标的店",    "shop_rating": 4.9,    "shop_sold_count": 233609,    "shop_user_id": "5f1eb2160000000001000c02",    "shop_follower_count": 6445,    "platform": "xiaohongshu"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campi della risposta

I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.

Campo	Significato
`id`	ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
`title`	Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo).
`url`	Il link del record su Xiaohongshu. I link di search, note, profile e hashtag di solito contengono un token di accesso, quindi si aprono anche in un browser senza aver effettuato l'accesso (il token scade; chiama di nuovo per un link aggiornato). I link alle note di user_posts non contengono token e ne richiedono uno per aprirsi in un browser: chiama note con l'ID della nota per ottenere un link che si apra. Nemmeno i link ai profili di search_users contengono token; chiama profile con lo user_id per ottenerne uno che si apra. I link alle note di pgy_content_square contengono un token, tranne con `keyword`, nel qual caso non ne contengono.
`price`	Prezzo come numero senza simbolo di valuta; vedi currency.
`original_price`	Prezzo di listino del prodotto prima dello sconto (product_search, product_detail), in CNY; uguale a price quando non c'è un prezzo barrato.
`currency`	Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta.
`in_stock`	Indica se il prodotto è attualmente disponibile (product_search, product_detail).
`category`	Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme.
`sold_count`	Unità vendute come le mostra la pagina del prodotto (product_search, product_detail): valore esatto nelle righe di ricerca; quando la pagina di dettaglio mostra un valore arrotondato come 72k+, questo campo riporta il limite inferiore (72000). Per i prodotti venduti a peso o a pezzi, il conteggio è in quell'unità. Assente quando la pagina non lo mostra.
`variant_name`	Nome della variante di questo SKU (product_detail), ad esempio una scatola.
`image_urls`	Array di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini.
`detail_image_urls`	Immagini della sezione con i dettagli del prodotto (product_detail), nell'ordine della pagina.
`attributes`	Attributi del prodotto (product_detail), ciascuno con name e value così come scritti nella pagina del prodotto, ad esempio un numero di registrazione dei cosmetici.
`shop_id`	ID del negozio (product_search, product_detail).
`shop_name`	Nome del negozio (product_search, product_detail).
`shop_rating`	Valutazione del negozio su 5 (product_detail); assente per un negozio nuovo che non ha ancora una valutazione.
`shop_sold_count`	Unità totali vendute dal negozio (product_detail).
`shop_user_id`	user_id dell'account Xiaohongshu del negozio (product_detail); funziona con profile e user_posts.
`shop_follower_count`	Follower dell'account Xiaohongshu del negozio (product_detail).
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

Errori e addebiti

401: Chiave mancante o non valida.
402: Saldo insufficiente. Effettua prima una ricarica.
422: Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
429: Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
503: Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
Risposta 200 vuota: Nessun dato. Nessun addebito.

Errori