API Amazon

L'API Amazon ti permette di cercare prodotti e ottenere informazioni dettagliate sui prodotti tramite ASIN. Entrambi gli endpoint supportano il targeting multi-regione, la localizzazione della valuta e l'emulazione del dispositivo.

Endpoint

Endpoint	Descrizione
`POST /api/v1/amazon/search`	Cerca prodotti Amazon con ordinamento, paginazione e filtri per categoria
`POST /api/v1/amazon/product`	Ottieni informazioni dettagliate sul prodotto tramite ASIN

Autenticazione

Intestazione	Valore	Richiesto
`Authorization`	`Bearer YOUR_API_KEY`	Sì
`Content-Type`	`application/json`	Sì

Ricerca prodotti

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Cerca prodotti Amazon e ottieni risultati strutturati che includono prezzi, valutazioni e dettagli del prodotto.

Corpo della richiesta

Parametro	Tipo	Predefinito	Descrizione
`query`	`string`	--	Richiesto. Query di ricerca (1-500 caratteri).
`domain`	`string`	`com`	Suffisso del dominio Amazon (es. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Ordine di ordinamento. Uno tra: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Numero di pagina iniziale (indicizzato da 1).
`pages`	`integer`	`1`	Numero di pagine da restituire.
`category_id`	`string`	--	ID categoria/dipartimento Amazon per restringere i risultati.
`merchant_id`	`string`	--	Filtra per un venditore Amazon specifico.
`country`	`string`	--	Codice paese per la localizzazione.
`language`	`string`	--	Codice lingua per i risultati.
`currency`	`string`	--	Codice valuta ISO 4217 (es. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codice postale per prezzi e disponibilità localizzati.
`autoselect_variant`	`boolean`	--	Seleziona automaticamente la variante predefinita del prodotto.

Esempio

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Esempio di risposta

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

Dettagli prodotto

Bash

POST https://api.scavio.dev/api/v1/amazon/product

Ottieni informazioni dettagliate per un prodotto Amazon specifico tramite il suo ASIN. Restituisce prezzo, descrizione, specifiche, immagini, valutazioni e informazioni sul venditore.

Corpo della richiesta

Parametro	Tipo	Predefinito	Descrizione
`query`	`string`	--	Richiesto. ASIN Amazon (es. `B09XS7JWHH`).
`domain`	`string`	`com`	Suffisso del dominio Amazon (es. `com`, `co.uk`, `de`).
`country`	`string`	--	Codice paese per la localizzazione.
`language`	`string`	--	Codice lingua per i risultati.
`currency`	`string`	--	Codice valuta ISO 4217 (es. `USD`, `EUR`).
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codice postale per prezzi localizzati.
`autoselect_variant`	`boolean`	--	Seleziona automaticamente la variante predefinita del prodotto.

Esempio

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Esempio di risposta

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Domini supportati

Usa il parametro domain per scegliere un marketplace Amazon specifico:

Dominio	Marketplace
`com`	Stati Uniti
`co.uk`	Regno Unito
`de`	Germania
`fr`	Francia
`co.jp`	Giappone
`ca`	Canada
`it`	Italia
`es`	Spagna
`in`	India
`com.au`	Australia
`com.br`	Brasile
`com.mx`	Messico

Formato della risposta

Entrambi gli endpoint restituiscono un wrapper di risposta coerente:

Campo	Tipo	Descrizione
`data`	`object \| null`	Il payload della risposta. `null` se la richiesta fallisce a monte. La ricerca restituisce `{page, products, html}`; il prodotto restituisce l'oggetto prodotto direttamente.
`response_time`	`number`	Tempo di risposta lato server in millisecondi
`credits_used`	`number`	Numero di crediti consumati
`credits_remaining`	`number`	Crediti rimanenti nel periodo di fatturazione corrente

Risposte di errore

Stato	Descrizione
`401`	Non autorizzato -- chiave API mancante o non valida
`429`	Limite di velocità o utilizzo superato per il tuo piano
`502`	Errore a monte -- riprova dopo un breve intervallo
`503`	Servizio a monte non disponibile -- riprova più tardi

Vedi Errori per il riferimento completo sugli errori e le best practice per i tentativi.

Correlati

Guida rapida -- ottieni la tua chiave API ed effettua la tua prima richiesta
API Google Search -- cerca su Google con dati SERP strutturati
API YouTube -- cerca video e estrai metadati
Limiti di frequenza -- limiti per livello del piano

API Amazon

Endpoint

Endpoint	Descrizione
`POST /api/v1/amazon/search`	Cerca prodotti Amazon con ordinamento, paginazione e filtri per categoria
`POST /api/v1/amazon/product`	Ottieni informazioni dettagliate sul prodotto tramite ASIN

Autenticazione

Intestazione	Valore	Richiesto
`Authorization`	`Bearer YOUR_API_KEY`	Sì
`Content-Type`	`application/json`	Sì

Ricerca prodotti

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Cerca prodotti Amazon e ottieni risultati strutturati che includono prezzi, valutazioni e dettagli del prodotto.

Corpo della richiesta

Parametro	Tipo	Predefinito	Descrizione
`query`	`string`	--	Richiesto. Query di ricerca (1-500 caratteri).
`domain`	`string`	`com`	Suffisso del dominio Amazon (es. `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	Ordine di ordinamento. Uno tra: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	Numero di pagina iniziale (indicizzato da 1).
`pages`	`integer`	`1`	Numero di pagine da restituire.
`category_id`	`string`	--	ID categoria/dipartimento Amazon per restringere i risultati.
`merchant_id`	`string`	--	Filtra per un venditore Amazon specifico.
`country`	`string`	--	Codice paese per la localizzazione.
`language`	`string`	--	Codice lingua per i risultati.
`currency`	`string`	--	Codice valuta ISO 4217 (es. `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codice postale per prezzi e disponibilità localizzati.
`autoselect_variant`	`boolean`	--	Seleziona automaticamente la variante predefinita del prodotto.

Esempio

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

Esempio di risposta

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

Dettagli prodotto

Bash

POST https://api.scavio.dev/api/v1/amazon/product

Ottieni informazioni dettagliate per un prodotto Amazon specifico tramite il suo ASIN. Restituisce prezzo, descrizione, specifiche, immagini, valutazioni e informazioni sul venditore.

Corpo della richiesta

Parametro	Tipo	Predefinito	Descrizione
`query`	`string`	--	Richiesto. ASIN Amazon (es. `B09XS7JWHH`).
`domain`	`string`	`com`	Suffisso del dominio Amazon (es. `com`, `co.uk`, `de`).
`country`	`string`	--	Codice paese per la localizzazione.
`language`	`string`	--	Codice lingua per i risultati.
`currency`	`string`	--	Codice valuta ISO 4217 (es. `USD`, `EUR`).
`device`	`string`	`desktop`	Tipo di dispositivo. Uno tra: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	Codice postale per prezzi localizzati.
`autoselect_variant`	`boolean`	--	Seleziona automaticamente la variante predefinita del prodotto.

Esempio

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

Esempio di risposta

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

Domini supportati

Usa il parametro domain per scegliere un marketplace Amazon specifico:

Dominio	Marketplace
`com`	Stati Uniti
`co.uk`	Regno Unito
`de`	Germania
`fr`	Francia
`co.jp`	Giappone
`ca`	Canada
`it`	Italia
`es`	Spagna
`in`	India
`com.au`	Australia
`com.br`	Brasile
`com.mx`	Messico

Formato della risposta

Entrambi gli endpoint restituiscono un wrapper di risposta coerente:

Campo	Tipo	Descrizione
`data`	`object \| null`	Il payload della risposta. `null` se la richiesta fallisce a monte. La ricerca restituisce `{page, products, html}`; il prodotto restituisce l'oggetto prodotto direttamente.
`response_time`	`number`	Tempo di risposta lato server in millisecondi
`credits_used`	`number`	Numero di crediti consumati
`credits_remaining`	`number`	Crediti rimanenti nel periodo di fatturazione corrente

Risposte di errore

Stato	Descrizione
`401`	Non autorizzato -- chiave API mancante o non valida
`429`	Limite di velocità o utilizzo superato per il tuo piano
`502`	Errore a monte -- riprova dopo un breve intervallo
`503`	Servizio a monte non disponibile -- riprova più tardi

Vedi Errori per il riferimento completo sugli errori e le best practice per i tentativi.

Correlati

Guida rapida -- ottieni la tua chiave API ed effettua la tua prima richiesta
API Google Search -- cerca su Google con dati SERP strutturati
API YouTube -- cerca video e estrai metadati
Limiti di frequenza -- limiti per livello del piano