개발자 문서 › API 레퍼런스

계정 엔드포인트

키 자체의 요금제, 스코프, 사용량, 그리고 계정 검색과 알림 피드입니다. 요금제와 사용량 조회는 0 크레딧입니다.

인증 · 크레딧 · 공통 매개변수 · 오류 코드 · openapi.json

GET /alerts

이 워크스페이스의 알림 피드입니다. 순위 하락과 상승, 검색 결과에 들어오거나 빠진 키워드, 경쟁 앱에 추월당하거나 추월한 변화, 경쟁 앱의 등록 정보 변경, Apple Ads 규칙과 관리 수수료 단계, 완료된 키워드 발굴 실행을 최신순으로, 읽지 않은 개수와 함께 반환합니다. 대시보드의 종 아이콘과 같은 피드입니다.

스코프
apps:read
크레딧
1
요금제
Free
매개변수위치타입설명
limitquerynumber행 수, 최대 500(기본값 50)
curl "https://storelift.net/v1/alerts" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /portfolio

워크스페이스의 모든 앱에 대한 오늘 현황을 앱당 한 행으로 반환합니다. 실시간 사용자, 사용자와 신규 사용자, 광고 수익, 구독 수익과 체험, 그리고 포트폴리오 합계, 시간대별·국가별 카드, 구독 이벤트 피드가 포함됩니다. 대시보드의 '오늘' 화면과 같은 수치입니다. 지난 날짜는 day로 지정합니다.

스코프
apps:read
크레딧
2
요금제
Free
매개변수위치타입설명
tzquerystring하루의 경계에 쓸 IANA 시간대, 예: Europe/Istanbul(기본값 UTC)
dayquerystring지난 날짜, YYYY-MM-DD 형식(기본값 오늘)
curl "https://storelift.net/v1/portfolio" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /account

이 키 또는 세션의 소유 정보입니다. 플랜, 인증 방식, 부여된 권한 범위, 읽을 수 있는 앱, 크레딧 잔액을 반환합니다. 크레딧이 들지 않습니다. 플랜, 권한 범위 또는 앱 문제로 호출이 거부되었을 때 호출하세요.

스코프
없음
크레딧
0
curl "https://storelift.net/v1/account" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET /usage

워크스페이스의 모든 한도를 사용량, 재설정 시각과 함께 반환합니다. 추적 키워드, 앱, 키워드 발굴, AI 질문, 리뷰 AI, AI 가시성, 키워드 스파이, API 크레딧, 오늘의 Hive 한도, 초당 요청 한도입니다. 크레딧이 들지 않습니다. used=null은 0이 아니라 이 플랜에서 해당 한도를 계량하지 않는다는 뜻입니다.

스코프
없음
크레딧
0
curl "https://storelift.net/v1/usage" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET /fetch

search가 반환한 ID 하나의 전체 레코드입니다. 앱 카드, 현재 상태와 순위 기록이 담긴 추적 키워드 하나, 또는 사용자를 앞서는 키워드가 담긴 경쟁 앱 하나를 반환합니다. id, title, url, 한 줄짜리 text, metadata를 반환합니다.

스코프
apps:read
크레딧
1
요금제
Free
매개변수위치타입설명
id필수querystringsearch가 반환한 그대로의 ID(app:…, kw:…, rival:…)
curl "https://storelift.net/v1/fetch?id=kw%3Asbx-lumen%3Aus%3Asleep%2520sounds" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답