API e dati per sviluppatori e agenti AI

Ultimo aggiornamento: 25 settembre 2026

In breve

SuperOffertissime mette a disposizione i dati delle offerte in forma strutturata, senza registrazione: un'API JSON in sola lettura e una versione Markdown delle pagine per gli assistenti AI. Base dell'API: https://superoffertissime.com/api/v1

Specifica OpenAPI: https://superoffertissime.com/api/v1/openapi.json
Catalogo delle API (RFC 9727): https://superoffertissime.com/.well-known/api-catalog
Riepilogo del catalogo per assistenti AI: https://superoffertissime.com/llms.txt

Endpoint

GET	Descrizione
/api/v1/offerte	Offerte attive, dalle più recenti. Parametri: categoria, tag, pagina, per_pagina (max 100).
/api/v1/offerte/{slug}	Dettaglio di un'offerta: descrizione originale, parere e storico dei prezzi rilevati.
/api/v1/categorie	Categorie con almeno un'offerta attiva e numero di offerte.
/api/v1/health	Stato del servizio (application/health+json).
/api/v1/openapi.json	Specifica OpenAPI 3.1.

Esempi

curl "https://superoffertissime.com/api/v1/offerte?per_pagina=5"
curl "https://superoffertissime.com/api/v1/offerte?categoria=tecnologia&pagina=2"
curl "https://superoffertissime.com/api/v1/offerte/<slug>"

Estratto di una risposta:

{
  "data": [{
    "slug": "…",
    "url": "https://superoffertissime.com/offerte/…",
    "buyUrl": "https://superoffertissime.com/go/…",
    "title": "…",
    "price": {
      "current": 23.99, "list": 49.99, "discountPercent": 52,
      "currency": "EUR", "checkedAt": "2026-09-25T08:30:00.000Z"
    },
    "editorNote": "…"
  }],
  "pagination": { "page": 1, "perPage": 24, "total": 7, "pages": 1 }
}

Regole da rispettare

Prezzi: restituiti solo se rilevati nelle ultime 24 ore, sempre con la data (price.checkedAt); altrimenti sono null. Citali insieme alla data: su Amazon.it possono cambiare in qualsiasi momento.
Link affiliati: buyUrl porta ad Amazon.it tramite il nostro link di affiliazione. Se lo mostri a un utente, indicalo come link affiliato.
Uso: gratuito e senza chiave, con cache di 60 secondi. Per un uso intensivo o integrazioni continuative scrivici prima a [email protected].

Markdown per agenti AI

Le pagine del sito (home, archivio, offerte, categorie, tag, chi siamo) sono disponibili anche in Markdown: basta richiederle con l'intestazione Accept: text/markdown. I browser continuano a ricevere l'HTML.

curl -H "Accept: text/markdown" "https://superoffertissime.com/offerte"