API Amazon Dettagli

Q: Come calcolo lo sconto di un prodotto?

Confronta list_price, il prezzo barrato, con price, il prezzo attuale, nella valuta indicata da currency. Se list_price manca, non dare per scontato che il prodotto sia in sconto.

Q: Posso confrontare direttamente le valutazioni con quelle di altri marketplace?

Prima convertile: rating_scale indica il valore massimo, cinque su Amazon, quindi riporta le valutazioni sulla stessa scala prima di confrontarle tra marketplace. Leggile anche insieme a rating_count, perché le valutazioni di poche persone oscillano molto.

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

Consulta un singolo prodotto Amazon dal link con il suo ASIN per ottenere titolo, brand, prezzo, valutazione, disponibilità, punti elenco delle caratteristiche, immagini e posizioni nelle classifiche dei bestseller. Qui profile indica la pagina del prodotto, non il profilo di un acquirente o di un venditore, e in_stock non è una quantità riservata.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su amazon e action impostato su profile. Prezzo $1.39 per 1.000 richieste ($0.001389 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.

La funzionalità Amazon Details legge un prodotto a partire dal suo link: ASIN, titolo, brand, prezzo e prezzo di listino, valutazione e numero di valutazioni, disponibilità, categoria, tutte le immagini, l'elenco puntato delle caratteristiche, descrizione, venditore, posizioni nelle classifiche dei più venduti e se ha il badge Amazon's Choice. Usala per analizzare nel dettaglio il prodotto di un concorrente, arricchire i tuoi record di prodotto o monitorare i prezzi.

Passa un link a un prodotto come https://www.amazon.com/dp/<ASIN>; qui i dettagli riguardano il prodotto, non un profilo utente. Imposta lang per la lingua della pagina, con zhcn per il cinese semplificato. Leggi la valuta da currency; list_price è il prezzo barrato, quindi insieme a price ti dà lo sconto.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Amazon Dettagli di EveryInfra (amazon/profile).

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 amazon e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
  - url: Specifica l'URL di un prodotto Amazon, ad esempio https://www.amazon.com/dp/<ASIN>. L'azione reviews estrae un ASIN alfanumerico maiuscolo di 10 caratteri dai percorsi /dp/, /gp/product/ o /product-reviews/.
- Parametri facoltativi:
  - lang: Specifica la lingua della pagina per gli endpoint Amazon supportati con codici validi come en o ja. Usa zhcn per il cinese semplificato e zhtw per il cinese tradizionale invece di un generico zh. (valori consentiti: ar / bn / cs / da / de / en / es / fr)
- Restituisce un oggetto. Campi principali: asin (Amazon Standard Identification Number,…), title, url, brand (Marca), price, list_price (Prezzo di listino (barrato)), currency, rating, rating_scale, rating_count, in_stock (Indica se il prodotto è disponibile), category; 19 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=amazon.
- Esempio di corpo della richiesta:
{
  "platform": "amazon",
  "action": "profile",
  "params": {
    "url": "https://www.amazon.com/dp/B09B8V1LZ3"
  }
}
- Prezzo: $1.39 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ì	`amazon`	Identificativo della piattaforma, valore fisso.
`action`	body	`string`	Sì	`profile`	Identificativo della funzionalità, valore fisso.
`url`	body.params	`string`	Sì	-	Specifica l'URL di un prodotto Amazon, ad esempio https://www.amazon.com/dp/<ASIN>. L'azione reviews estrae un ASIN alfanumerico maiuscolo di 10 caratteri dai percorsi /dp/, /gp/product/ o /product-reviews/; le homepage degli store non sono supportate. Con questo parametro, profile recupera la pagina dei dettagli del prodotto, non i dati del profilo di un utente.
`lang`	body.params	`string (enum)`	No	-	Specifica la lingua della pagina per gli endpoint Amazon supportati con codici validi come en o ja. Usa zhcn per il cinese semplificato e zhtw per il cinese tradizionale invece di un generico zh. Le richieste accettano solo i codici lingua elencati per l'azione, e la lingua scelta modifica il contenuto visualizzato, non lo store del paese di destinazione.Valori consentiti`arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw`

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": "amazon",
  "action": "profile",
  "params": {
    "url": "https://www.amazon.com/dp/B09B8V1LZ3"
  }
}'

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": "amazon",  "action": "profile",  "results": {    "asin": "B09B8V1LZ3",    "title": "Amazon Echo Dot (newest model) - Vibrant sounding speaker, Designed for Alexa+, Great for bedrooms, dining rooms and offices, Charcoal",    "url": "https://www.amazon.com/dp/B09B8V1LZ3",    "brand": "Amazon",    "price": 79.99,    "currency": "$",    "rating": 4.7,    "rating_count": 200079,    "in_stock": true,    "category": "",    "image_url": "https://m.media-amazon.com/images/I/61J2sQtBYDL._AC_SY300_SX300_QL70_FMwebp_.jpg",    "is_amazon_choice": false,    "seller_name": "Amazon.com",    "platform": "amazon",    "images": [      "https://m.media-amazon.com/images/I/61J2sQtBYDL._AC_SL1500_.jpg",      "https://m.media-amazon.com/images/I/71hNp8d9WvL._AC_SL1500_.jpg",      "https://m.media-amazon.com/images/I/71kDL97LTgL._AC_SL1500_.jpg"    ],    "features": [      "Your favorite music and content – Play music, audiobooks, and podcasts from Amazon Music, Apple Music, Spotify and others or via Bluetooth throughout your home.",      "Alexa is happy to help – Ask Alexa for weather updates and to set hands-free timers, get answers to your questions and even hear jokes. Need a few extra minutes in the morning? Just tap your Echo Dot to snooze your alarm.",      "Keep your home comfortable – Control compatible smart home devices with your voice and routines triggered by built-in motion or indoor temperature sensors. Create routines to automatically turn on lights when you walk into a room, or start a fan if the inside temperature goes abo…"    ],    "bestseller_ranks": [      {        "rank": 1,        "category": "Wireless Multiroom Digital Music Systems"      }    ],    "rating_scale": 5  },  "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
`asin`	Amazon Standard Identification Number, l'ID univoco del prodotto all'interno di uno store.
`title`	Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo).
`url`	Link al record sulla piattaforma.
`brand`	Marca.
`price`	Prezzo come numero senza simbolo di valuta; vedi currency.
`list_price`	Prezzo di listino (barrato).
`currency`	Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta.
`rating`	Valutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito.
`rating_scale`	Valore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione.
`rating_count`	Numero di persone che hanno espresso una valutazione. null significa non reso noto, non 0.
`in_stock`	Indica se il prodotto è disponibile.
`category`	Nome della categoria secondo la tassonomia della piattaforma, non normalizzato tra piattaforme.
`image_url`	Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls.
`description`	Riepilogo o descrizione, di solito più breve di text.
`is_amazon_choice`	Indica se il prodotto ha il badge Amazon's Choice.
`seller_name`	Nome del venditore.
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
`images`	Array di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini.
`features`	Elenco puntato delle caratteristiche riportate nella pagina del prodotto (search, profile), così come sono scritte; assente se non ce ne sono.
`bestseller_ranks`	Posizioni nelle classifiche Best Sellers (search, profile): ogni elemento ha rank e category, una voce per categoria; è la posizione al momento della lettura, non un dato di vendita.

FAQ

Details restituisce un profilo utente?

No. Su Amazon legge i dettagli del prodotto: passi il link a un prodotto e ottieni prezzo, valutazione, immagini, venditore e dati correlati del prodotto. Non vengono mai coinvolte informazioni sugli utenti.

Come calcolo lo sconto di un prodotto?

Confronta list_price, il prezzo barrato, con price, il prezzo attuale, nella valuta indicata da currency. Se list_price manca, non dare per scontato che il prodotto sia in sconto.

Posso confrontare direttamente le valutazioni con quelle di altri marketplace?

Prima convertile: rating_scale indica il valore massimo, cinque su Amazon, quindi riporta le valutazioni sulla stessa scala prima di confrontarle tra marketplace. Leggile anche insieme a rating_count, perché le valutazioni di poche persone oscillano molto.

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

Riferimenti ufficiali

Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.

Amazon: cos'è un ASIN e come trovarlo ↗
Amazon definisce l'ASIN come un identificatore di prodotto alfanumerico di 10 caratteri e indica che si trova dopo /dp/ nei link alle pagine di dettaglio dei prodotti.
Verificato il 2026-09-04