API

L’API restituisce i tuoi dati e nient’altro: le schede del tuo account, i risultati ottenuti, le recensioni lasciate dalle persone e i concorrenti che hai messo sotto osservazione. È un’API in sola lettura. Tutto ciò che modifica i dati si fa nella dashboard, quindi una chiave trapelata può copiare i tuoi numeri, ma non può modificare la tua scheda, non può spendere denaro e non può toccare l’account di nessun altro.

È gratuita, come tutto il resto qui. Ogni account può generare una chiave dalla dashboard.

La chiave

Crea la chiave nella tua dashboard, nella scheda Strumenti per le schede, nel blocco chiamato Esportazioni e accesso API. Ha la forma sl_ seguito da 48 caratteri esadecimali, e la dashboard mostra la data in cui è stata emessa.

Una chiave per account. Premendo Nuova chiave se ne genera una nuova e la precedente smette di funzionare in quel momento. Non c’è un periodo di tolleranza né una seconda chiave attiva in parallelo, quindi cambiala quando sei pronto ad aggiornare ciò che la usa.

Ruotala se è finita in un repository pubblico, in un documento condiviso, in un browser o in un servizio che non usi più. La rotazione richiede un clic e non costa nulla.

Revocala eliminandola nello stesso blocco. L’account continua a funzionare, si interrompe soltanto l’accesso API.

Tratta la chiave come una password. Tienila su un server, in una variabile d’ambiente o in un archivio dei segreti, mai nel codice front end: qualsiasi cosa presente in un browser può essere letta da chiunque apra la pagina. Su questi endpoint non inviamo intestazioni CORS, di proposito, così una pagina in un browser su un altro dominio non può chiamarli con la tua chiave.

Come chiamarla

Ogni richiesta porta la chiave nell’intestazione Authorization. L’indirizzo di base è https://saasledge.com/api/v1.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/me

Le risposte sono in JSON con "ok": true. Gli errori mantengono la stessa forma, con "ok": false e un breve codice leggibile da una macchina.

Il limite è di 120 richieste al minuto per chiave. È ampio per un’esportazione notturna e stretto per un ciclo che ha dimenticato di fermarsi.

GET /api/v1/me

L’account associato alla chiave e i limiti rispetto ai quali si calcola tutto il resto. Usalo come controllo di stato.

{
  "ok": true,
  "account": {
    "email": "[email protected]",
    "products": 3,
    "since": "2026-08-13"
  },
  "key": { "issued_at": "2026-08-14 09:12:33" },
  "limits": {
    "products": 25,
    "watches": 25
  },
  "rate": { "limit": 120, "per": "minute" }
}

GET /api/v1/products

Le tue schede con tutto ciò che vi è pubblicato: stato, categoria, modello di prezzo, piani, numero di screenshot, numero di recensioni e valutazione media. Ogni elemento riporta url_on_saasledge, l’indirizzo pubblico della scheda.

curl -H "Authorization: Bearer sl_your_key" \
  https://saasledge.com/api/v1/products

GET /api/v1/stats

Visualizzazioni delle tue schede e clic verso il tuo sito web, raggruppati per giorno.

I giorni senza eventi non vengono restituiti. I totali sono già calcolati in totals, compreso il tasso di clic in percentuale.

curl -H "Authorization: Bearer sl_your_key" \
  "https://saasledge.com/api/v1/stats?days=90&format=csv" -o stats.csv

GET /api/v1/reviews

Le recensioni pubblicate sulle tue schede, con le tue risposte e le date. without_reply conta quelle ancora in attesa di risposta, che è il numero su cui vale la pena impostare un avviso.

Gli indirizzi email di chi scrive le recensioni non vengono mai restituiti. Li raccogliamo per poter controllare una recensione, non per scrivere a chi l’ha lasciata.

GET /api/v1/watches

I concorrenti nella tua lista di monitoraggio: prezzo d’ingresso attuale e prima dell’ultima modifica, numero di piani, indicatori di piano gratuito e di prova, valutazione, numero di recensioni e storico dei prezzi nella finestra richiesta. La stessa risposta contiene mine, il prezzo d’ingresso e il numero di piani delle tue schede pubblicate, così per un confronto basta una richiesta anziché due.

Che cosa l’API non farà

Non mostrerà i dati privati di un altro fornitore, non scriverà nulla e non esporterà l’intero catalogo. La copia in blocco del catalogo non è qualcosa che vendiamo e non è qualcosa che la chiave apre.

Domande, o un caso d’uso che richiede un campo che non restituiamo ancora: scrivi a [email protected] e racconta che cosa stai costruendo.