← Home

API prezzi Amazon

Invia una lista di ASIN e ricevi, letti da Amazon in quel momento, prezzo Buy Box, prezzo minimo del nuovo, prezzo minimo dell'usato, titolo e immagine. Ogni ASIN letto costa 1 token.

Per iniziare

  1. Crea un account e scegli un piano nella sezione API della dashboard.
  2. Genera la tua chiave API: la vedi una volta sola, conservala al sicuro.
  3. Chiama l'endpoint con la chiave nell'header X-API-Key.
POST https://maurotracks.com/api/v1/products

Autenticazione

Ogni richiesta deve avere l'header X-API-Key con la tua chiave. Se la chiave viene esposta, rigenerala dalla dashboard: la vecchia smette subito di funzionare.

X-API-Key: mte_live_…

Richiesta

Corpo JSON con due campi:

  • marketplace: uno tra: it, de, fr, es, co.uk, com, co.jp
  • asins: lista da 1 a 300 ASIN (10 caratteri). Maiuscole e spazi non contano, i duplicati contano una volta.
{ "marketplace": "it", "asins": ["B0C95J98LV", "B07DFDXV44"] }

Risposta

I risultati seguono l'ordine della richiesta (senza duplicati). I prezzi mancanti valgono null; currency è la valuta del marketplace.

found: false senza error = l'ASIN non esiste o non è venduto su quel marketplace. error: "invalid_asin" = formato non valido. error: "upstream_error" = Amazon non ha risposto per quell'ASIN: riprova più tardi.

{
  "marketplace": "it",
  "currency": "EUR",
  "results": [
    {
      "asin": "B0C95J98LV",
      "found": true,
      "title": "Beats Studio Pro - Cuffie Bluetooth wireless…",
      "image_url": "https://m.media-amazon.com/images/I/61u-OaDSfQL.jpg",
      "price_buybox": 184.0,
      "price_min_new": 184.0,
      "price_used": 175.98,
      "fetched_at": "2026-11-08T10:39:00Z"
    },
    { "asin": "B000000000", "found": false },
    { "asin": "XYZ", "found": false, "error": "invalid_asin" }
  ],
  "tokens_used": 1,
  "tokens_remaining": 4999
}

Token

Paghi 1 token per ogni ASIN per cui ricevi dati (found: true). ASIN non validi, duplicati, non trovati o in errore non costano nulla.

Se i token rimasti non bastano per tutti gli ASIN validi della richiesta, la richiesta viene rifiutata per intero (402 tokens_exhausted) e non consuma niente.

I token si azzerano a ogni rinnovo mensile. Se li finisci prima, dalla dashboard puoi rinnovare subito: paghi un mese e il nuovo periodo parte da quel momento.

Errori

{ "error": "tokens_exhausted", "message": "Not enough tokens: 25 needed, 19 left" }
HTTPerrorSignificato
400invalid_requestCorpo non valido: il campo message spiega cosa correggere
401invalid_api_keyChiave mancante, errata o rigenerata
402no_subscriptionNessun abbonamento API attivo (scaduto, cancellato o pagamento non riuscito)
402tokens_exhaustedToken insufficienti per questa richiesta
403account_suspendedAccount sospeso
429rate_limitedTroppe richieste al minuto: riprova dopo Retry-After secondi
502upstream_errorAmazon non raggiungibile: nessun token addebitato
503maintenanceServizio in manutenzione, riprova tra poco

Limiti

  • Fino a 300 ASIN per richiesta.
  • Fino a 60 richieste al minuto per account.
  • Liste lunghe vengono lette a blocchi verso Amazon: una richiesta da 300 ASIN può richiedere qualche decina di secondi. Imposta un timeout lato client di almeno 120 secondi.

Esempi

curl

curl -X POST https://maurotracks.com/api/v1/products \
  -H "X-API-Key: $MTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"marketplace": "it", "asins": ["B0C95J98LV", "B07DFDXV44"]}'

Python

import os, requests

r = requests.post(
    "https://maurotracks.com/api/v1/products",
    headers={"X-API-Key": os.environ["MTE_API_KEY"]},
    json={"marketplace": "it", "asins": ["B0C95J98LV", "B07DFDXV44"]},
    timeout=120,
)
r.raise_for_status()
for p in r.json()["results"]:
    print(p["asin"], p.get("price_buybox"), p.get("title"))

JavaScript

const res = await fetch("https://maurotracks.com/api/v1/products", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.MTE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ marketplace: "it", asins: ["B0C95J98LV", "B07DFDXV44"] }),
  signal: AbortSignal.timeout(120_000),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error}: ${data.message}`);
console.log(data.results, data.tokens_remaining);

Piani e prezzi

Abbonamento mensile senza vincoli: puoi cancellare quando vuoi.

Basic

6,29 €/mese

5000 token al mese

Pro

19,99 €/mese

25.000 token al mese

Business

54,99 €/mese

100.000 token al mese

Enterprise

174,99 €/mese

500.000 token al mese

Crea un account