Storelift API

01기본 주소와 인증

기본 주소는 https://storelift.net/v1입니다. 설정 → API에서 키를 만드세요. 키는 한 번만 표시되고 해시로만 저장되므로, 잃어버린 키는 복구되지 않고 새로 발급합니다.

키는 x-api-key로 보내거나, 클라이언트가 Authorization 헤더만 지원한다면 bearer 토큰으로 보냅니다.

curl -s https://storelift.net/v1/apps \
  -H "x-api-key: sl_live_..."

029개 엔드포인트

/apps/{id} 아래의 엔드포인트는 country(us 같은 스토어프런트 코드, 기본값은 앱의 첫 번째 스토어프런트)를 받으며, 두 스토어가 모두 측정되는 경우 platform=ios|android도 받습니다.

03세 가지 측정 상태는 API에서도 그대로 유지됩니다

연동을 작성하기 전에 꼭 읽어 둘 부분입니다. 순위 필드는 숫자일 수 있지만, 숫자가 없다는 것은 서로 다른 두 가지를 뜻하며 API는 이 둘을 구분해서 전달합니다.

• measured: true, rank: 7 — 앱이 7위에서 발견되었습니다.
• measured: true, rank: null — 검색은 실행되었지만, 저희가 읽은 깊이 안의 결과에 앱이 없었습니다.
• measured: false — 그날은 검색을 실행하지 못했습니다. 순위에 대해 알려진 것이 없습니다.

{
  "country": "de",
  "platform": "ios",
  "live": true,
  "measuredAt": "2026-09-19T02:14:08.921Z",
  "keywords": [
    { "term": "traumdeutung", "measured": true,  "rank": 7,    "demand": 6, "searchDepth": 200 },
    { "term": "traumsymbole", "measured": true,  "rank": null, "demand": 3, "searchDepth": 200 },
    { "term": "traumtagebuch", "measured": false, "rank": null, "demand": null, "searchDepth": null }
  ]
}

뒤의 두 경우를 0으로 합쳐 버리면 실제로 일어나지 않은 급락을 묘사하게 되고, 그 위에 쌓은 모든 평균이 틀어집니다. 코드에서 숫자 하나가 필요하다면 measured: false를 값이 아니라 시계열의 빈 구간으로 처리하세요.

04하지 않는 일

• 쓰기를 하지 않습니다. 모든 엔드포인트는 GET이며, 다른 메서드는 method_not_allowed를 반환합니다. API에서 내 스토어 페이지, 추적 키워드, 결제로 이어지는 경로는 없습니다.
• 요청 시 측정하지 않습니다. 엔드포인트는 매일 밤 측정에서 수집된 데이터를 읽습니다. 두 번 요청해도 스토어에 두 번째 쿼리가 가지 않습니다.
• 매출 레이어는 제공하지 않습니다. 연결된 계정(App Store Connect, Apple Ads, RevenueCat, GA4)은 대시보드에만 남습니다. 빠뜨린 것이 아니라 의도적으로 그은 선입니다.
• 기록은 플랜에 따라 잘립니다. history와 charts 모두 플랜의 기간에서 잘리므로, 같은 키로 한 엔드포인트를 통해 다른 엔드포인트보다 더 먼 과거에 접근할 수 없습니다.

05오류

모든 오류는 error 필드가 있는 JSON입니다. plan_required는 plan도 함께 반환하므로, 클라이언트가 추측하지 않고 키가 어떤 플랜에 있는지 알려 줄 수 있습니다.

다음 읽을거리