API | SAASLEDGE

API는 본인의 데이터만 반환합니다. 계정에 있는 등록 페이지, 그 성과, 사람들이 남긴 리뷰, 그리고 추적 중으로 지정한 경쟁사입니다. 읽기 전용 API입니다. 데이터를 바꾸는 모든 작업은 대시보드에서 이루어지므로, 키가 유출되더라도 숫자를 복사해 갈 수는 있지만 등록 페이지를 수정하거나 비용을 쓰거나 다른 사람의 계정에 접근할 수는 없습니다.

다른 기능과 마찬가지로 무료입니다. 모든 계정이 대시보드에서 키를 발급받을 수 있습니다.

키

키는 대시보드의 등록 도구 탭에 있는 내보내기 및 API 액세스 블록에서 만듭니다. 키는 sl_ 뒤에 16진수 48자가 붙은 형태이며, 대시보드에 발급 날짜가 표시됩니다.

계정당 키는 하나입니다. 새 키를 누르면 새 키가 발급되고 이전 키는 그 순간부터 작동하지 않습니다. 유예 기간도, 병행해서 쓸 수 있는 두 번째 키도 없으니, 키를 쓰는 곳을 바꿀 준비가 되었을 때 교체하세요.

키를 교체하세요. 공개 저장소, 공유 문서, 브라우저, 더 이상 쓰지 않는 서비스에 키가 남았다면 교체해야 합니다. 교체는 클릭 한 번이면 되고 비용은 없습니다.

키를 폐기하려면 같은 블록에서 삭제하세요. 계정은 그대로 유지되고 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건을 초과하여 요청

한도는 키당 분당 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`	all	등록 페이지 슬러그, 예: `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`	all	등록 페이지 슬러그

리뷰 작성자의 이메일 주소는 반환되지 않습니다. 이메일은 리뷰를 확인하기 위해 수집하는 것이며, 메일을 보내기 위한 것이 아닙니다.

GET /api/v1/watches

추적 목록에 있는 경쟁사의 정보입니다. 현재 시작 가격과 직전 변경 전 가격, 요금제 수, 무료 요금제 및 체험 여부 표시, 평점, 리뷰 수, 기간 내 가격 변동 내역이 포함됩니다. 같은 응답에 mine, 즉 본인의 공개 중인 등록 페이지의 시작 가격과 요금제 수도 들어 있어서, 비교하는 데 요청이 두 번이 아니라 한 번이면 됩니다.

매개변수	기본값	비고
`days`	90	1에서 365, 가격 변동 내역에 적용

API가 하지 않는 것

다른 공급사의 비공개 데이터를 보여 주지 않고, 아무것도 쓰지 않으며, 카탈로그 전체를 내보내지도 않습니다. 카탈로그를 통째로 복사하는 것은 저희가 판매하는 것이 아니며 키로 열리는 기능도 아닙니다.

질문이 있거나 아직 반환하지 않는 필드가 필요한 사용 사례가 있다면 [email protected]으로 무엇을 만들고 계신지 알려 주세요.