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.
POST https://maurotracks.com/api/v1/productsOgni 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_…Corpo JSON con due campi:
marketplace: uno tra: it, de, fr, es, co.uk, com, co.jpasins: lista da 1 a 300 ASIN (10 caratteri). Maiuscole e spazi non contano, i duplicati contano una volta.{ "marketplace": "it", "asins": ["B0C95J98LV", "B07DFDXV44"] }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
}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.
{ "error": "tokens_exhausted", "message": "Not enough tokens: 25 needed, 19 left" }| HTTP | error | Significato |
|---|---|---|
| 400 | invalid_request | Corpo non valido: il campo message spiega cosa correggere |
| 401 | invalid_api_key | Chiave mancante, errata o rigenerata |
| 402 | no_subscription | Nessun abbonamento API attivo (scaduto, cancellato o pagamento non riuscito) |
| 402 | tokens_exhausted | Token insufficienti per questa richiesta |
| 403 | account_suspended | Account sospeso |
| 429 | rate_limited | Troppe richieste al minuto: riprova dopo Retry-After secondi |
| 502 | upstream_error | Amazon non raggiungibile: nessun token addebitato |
| 503 | maintenance | Servizio in manutenzione, riprova tra poco |
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);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