API | SAASLEDGE

APIが返すのは、ご自身のデータだけです。アカウントにある掲載ページ、その実績、寄せられたレビュー、監視リストに入れた競合製品です。これは読み取り専用のAPIです。データを変更する操作はすべてダッシュボードで行うため、キーが漏えいしても、数字をコピーされるだけです。掲載ページの編集も、課金も、他人のアカウントへの操作もできません。

ほかの機能と同じく無料です。どのアカウントでも、ダッシュボードからキーを発行できます。

キー

キーは、ダッシュボードの掲載ツールタブにある「エクスポートとAPIアクセス」というブロックで作成します。形式はsl_のあとに16進数48文字が続く文字列で、発行日もダッシュボードに表示されます。

キーはアカウントにつき1つです。 「新しいキー」を押すと新しいキーが発行され、直前のキーはその瞬間に使えなくなります。猶予期間はなく、2つのキーを並行して使うこともできません。キーを使っているものを更新する準備ができてから変更してください。

キーを再発行してください。 公開リポジトリ、共有ドキュメント、ブラウザ、使わなくなったサービスにキーが残ってしまった場合です。再発行はワンクリックで、費用はかかりません。

キーを無効にするには、 同じブロックで削除します。アカウントはそのまま使え、止まるのはAPIアクセスだけです。

キーはパスワードと同じように扱ってください。サーバー上、環境変数、シークレットストアに置き、フロントエンドのコードには決して入れないでください。ブラウザにあるものは、ページを開いた人なら誰でも読めます。これらのエンドポイントでは、意図的にCORSヘッダーを返していません。そのため、別ドメインのブラウザ上のページから、キーを使って呼び出すことはできません。

呼び出し方

すべてのリクエストで、Authorizationヘッダーにキーを入れます。ベースアドレスはhttps://saasledge.com/api/v1です。

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

レスポンスは"ok": trueを含むJSONです。エラーも同じ形で、"ok": falseと、機械で読める短いコードが返ります。

ステータス	コード	意味
401	`unauthorized`	キーがない、形式が正しくない、または存在しないキー
402	`plan_required`	キーは有効だが、アカウントがStudioプランではない
429	`rate`	このキーで1分間に120回を超えるリクエスト

上限は、キー1つにつき1分間に120リクエストです。夜間のエクスポートには十分ですが、止め忘れたループには厳しい値です。

GET /api/v1/me

キーに紐づくアカウントと、ほかのすべての件数が数えられる上限です。ヘルスチェックに使えます。

{
  "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

掲載ページと、そこに公開されているすべての情報です。状態、カテゴリ、料金体系、プラン、スクリーンショットの数、レビュー件数、平均評価が含まれます。各項目には、掲載ページの公開アドレスであるurl_on_saasledgeが付きます。

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

GET /api/v1/stats

掲載ページの閲覧数と、ご自身のウェブサイトへのクリック数を、日ごとにまとめたものです。

パラメータ	既定値	備考
`days`	30	1から365
`product`	すべて	掲載ページのスラッグ。例：`wave`
`format`	json	`csv`を指定すると、列が`product,day,views,clicks`のファイルを返します

イベントのない日は返されません。合計はtotalsに集計されており、クリック率もパーセントで含まれます。

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

GET /api/v1/reviews

掲載ページに公開されたレビューと、ご自身の返信、その日付です。without_replyは、まだ返信していないレビューの件数で、通知の対象にするとよい数字です。

パラメータ	既定値	備考
`days`	90	1から365
`product`	すべて	掲載ページのスラッグ

レビュー投稿者のメールアドレスは、返されることはありません。収集しているのはレビューを確認するためで、メールを送るためではありません。

GET /api/v1/watches

監視リストにある競合製品の情報です。現在の最低価格と直前の変更前の価格、プラン数、無料プランと無料トライアルのフラグ、評価、レビュー件数、期間内の価格履歴が含まれます。同じレスポンスにmineも入っており、ご自身の公開中の掲載ページの最低価格とプラン数がわかります。比較のためのリクエストは、2回ではなく1回で済みます。

パラメータ	既定値	備考
`days`	90	1から365。価格履歴の期間に適用されます

APIにできないこと

他の提供企業の非公開データは表示しません。何かを書き込むこともしません。カタログ全体のエクスポートもできません。カタログの一括コピーは、販売していないものであり、キーで開くものでもありません。

ご質問や、まだ返していない項目が必要な使い方については、[email protected]まで、何をつくろうとしているかを添えてご連絡ください。