Die API liefert Ihre eigenen Daten und sonst nichts: die Einträge in Ihrem Konto, wie sie abgeschnitten haben, die Bewertungen, die Leute dazu hinterlassen haben, und die Wettbewerber, die Sie beobachten. Es ist eine reine Lese-API. Alles, was Daten verändert, geschieht im Dashboard. Ein abgeflossener Schlüssel kann also Ihre Zahlen kopieren, aber weder Ihren Eintrag bearbeiten noch Geld ausgeben noch ein fremdes Konto berühren.
Sie ist kostenlos, wie alles andere hier. Jedes Konto kann im Dashboard einen Schlüssel ausstellen.
Der Schlüssel
Erstellen Sie den Schlüssel in Ihrem Dashboard auf dem Tab Eintrags-Tools, im Block „Exports and API access“. Er sieht aus wie sl_ gefolgt von 48 Hexadezimalzeichen, und das Dashboard zeigt das Ausstellungsdatum.
Ein Schlüssel pro Konto. Mit „New key“ wird ein neuer ausgestellt, und der vorherige Schlüssel funktioniert in diesem Moment nicht mehr. Es gibt keine Übergangsfrist und keinen zweiten Schlüssel parallel, ändern Sie ihn also erst, wenn Sie bereit sind, alles zu aktualisieren, was ihn verwendet.
Erneuern Sie ihn, wenn er in einem öffentlichen Repository, einem geteilten Dokument, einem Browser oder einem Dienst gelandet ist, den Sie nicht mehr nutzen. Die Erneuerung dauert einen Klick und kostet nichts.
Widerrufen Sie ihn, indem Sie ihn im selben Block löschen. Das Konto funktioniert weiter, nur der API-Zugriff endet.
Behandeln Sie den Schlüssel wie ein Passwort. Bewahren Sie ihn auf einem Server auf, in einer Umgebungsvariable oder einem Secret Store, niemals im Frontend-Code: Alles in einem Browser kann lesen, wer die Seite öffnet. Wir senden auf diesen Endpunkten bewusst keine CORS-Header, damit eine Browserseite auf einer anderen Domain sie nicht mit Ihrem Schlüssel aufrufen kann.
Aufruf
Jede Anfrage trägt den Schlüssel im Authorization-Header. Die Basisadresse ist https://saasledge.com/api/v1.
curl -H "Authorization: Bearer sl_your_key" \
https://saasledge.com/api/v1/me
Antworten sind JSON mit "ok": true. Fehler haben dieselbe Form mit "ok": false und einem kurzen maschinenlesbaren Code.
| Status | Code | Bedeutung |
|---|---|---|
| 401 | unauthorized |
Kein Schlüssel, ein fehlerhafter Schlüssel oder ein Schlüssel, den es nicht mehr gibt |
| 402 | plan_required |
Der Schlüssel ist echt, aber das Konto ist nicht auf Studio |
| 429 | rate |
Mehr als 120 Anfragen pro Minute mit diesem Schlüssel |
Das Limit liegt bei 120 Anfragen pro Minute und Schlüssel. Das ist großzügig für einen nächtlichen Export und knapp für eine Schleife, die vergessen hat aufzuhören.
GET /api/v1/me
Das Konto hinter dem Schlüssel und die Limits, an denen alles andere gemessen wird. Nutzen Sie es als Health-Check.
{
"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
Ihre Einträge mit allem, was darauf veröffentlicht ist: Status, Kategorie, Preismodell, Tarife, Anzahl der Screenshots, Anzahl der Bewertungen und Durchschnittsbewertung. Jedes Element enthält url_on_saasledge, die öffentliche Adresse des Eintrags.
curl -H "Authorization: Bearer sl_your_key" \
https://saasledge.com/api/v1/products
GET /api/v1/stats
Aufrufe Ihrer Einträge und Klicks auf Ihre Website, gruppiert nach Tag.
| Parameter | Standard | Hinweise |
|---|---|---|
days |
30 | 1 bis 365 |
product |
alle | Ein Eintrags-Slug, zum Beispiel wave |
format |
json | csv liefert eine Datei mit den Spalten product,day,views,clicks |
Tage ohne Ereignisse werden nicht zurückgegeben. Die Summen werden für Sie in totals gezählt, einschließlich der Klickrate in Prozent.
curl -H "Authorization: Bearer sl_your_key" \
"https://saasledge.com/api/v1/stats?days=90&format=csv" -o stats.csv
GET /api/v1/reviews
Veröffentlichte Bewertungen zu Ihren Einträgen, mit Ihren Antworten und den Daten. without_reply zählt die, die noch auf eine Antwort warten, und das ist die Zahl, bei der sich ein Alarm lohnt.
| Parameter | Standard | Hinweise |
|---|---|---|
days |
90 | 1 bis 365 |
product |
alle | Ein Eintrags-Slug |
E-Mail-Adressen der Bewertenden werden nie zurückgegeben. Sie werden erhoben, damit wir eine Bewertung prüfen können, nicht damit man ihnen schreibt.
GET /api/v1/watches
Die Wettbewerber auf Ihrer Beobachtungsliste: Einstiegspreis jetzt und vor der letzten Änderung, Anzahl der Tarife, Kennzeichen für kostenlosen Tarif und Testphase, Bewertung, Anzahl der Bewertungen und der Preisverlauf innerhalb des Zeitfensters. Dieselbe Antwort enthält mine, den Einstiegspreis und die Tarifanzahl Ihrer eigenen veröffentlichten Einträge, sodass für einen Vergleich eine Anfrage genügt statt zwei.
| Parameter | Standard | Hinweise |
|---|---|---|
days |
90 | 1 bis 365, gilt für den Preisverlauf |
Was die API nicht tut
Sie zeigt keine privaten Daten anderer Anbieter, sie schreibt nichts, und sie exportiert nicht den ganzen Katalog. Das massenhafte Kopieren des Katalogs verkaufen wir nicht, und der Schlüssel öffnet es nicht.
Fragen oder ein Anwendungsfall, der ein Feld braucht, das wir noch nicht zurückgeben: Schreiben Sie an [email protected] und sagen Sie, was Sie bauen.