내 앱 엔드포인트

GET /apps

이 Storelift 계정에서 추적 중인 앱을 나열합니다(ID, 이름, 국가, 키워드). 가장 먼저 호출하세요. 다른 모든 도구에는 여기서 얻은 appId가 필요합니다.

스코프

apps:read

크레딧

1

요금제

Free

curl "https://storelift.net/v1/apps" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/keywords

App Store / Google Play의 한 국가에서 한 앱의 키워드 순위입니다. 세 가지 상태는 서로 다릅니다. measured=false는 쿼리를 측정하지 못했다는 뜻이고, rank=null은 측정했지만 앱이 상위 결과에 없었다는 뜻이며, rank=<number>는 순위입니다. 절대 하나로 합치지 마세요. 측정하지 못한 날을 0으로 세면 잘못된 답이 나옵니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/keywords?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/rivals

검색에서 이 앱보다 순위가 높은 앱입니다. 경쟁 앱마다 그 앱이 앞서는 키워드, 해당 키워드에서 그 앱의 순위(theirRank)와 내 앱의 순위(ourRank)를 반환합니다. ourRank가 null이면 그 키워드에서 앱이 전혀 노출되지 않는다는 뜻입니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/rivals?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/ai

AI 엔진 답변을 날짜별 표본으로 모은 것 속 앱 언급입니다. ChatGPT, Claude, Gemini가 모든 사용자에게 보여 주는 내용을 재현한 것은 아닙니다. Studio 또는 Enterprise와 ai:read 권한 범위가 필요합니다. engines에는 측정한 각 엔진의 답변이 담기고, providers는 measured, failed, not_measured 상태를 알려 줍니다. 사용할 수 없는 엔진은 0점이 아닙니다. 날짜가 표시된 표본과 질문 수를 함께 읽으세요. 보편적인 순위도, 모든 소비자용 답변을 측정한 값도 아닙니다.

스코프

ai:read

크레딧

1

요금제

Studio

함께 받는 매개변수: appId (필수) · country

curl "https://storelift.net/v1/apps/sbx-lumen/ai?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/ai-check

한 국가의 한 앱에 대해 AI 가시성 표본 수집을 시작합니다. 해당 실행에서 사용할 수 있는 엔진을 씁니다. Studio 또는 Enterprise와 ai:read 권한 범위가 필요하며, Pro의 패널 한도로는 이 MCP 도구를 사용할 수 없습니다. 플랜에 포함되었거나 구매한 AI 가시성 실행 1회를 사용합니다. 결과는 get_ai_visibility가 반환합니다. 앱당 한 번에 하나의 측정만 실행됩니다.

스코프

ai:read

크레딧

1

요금제

Studio

함께 받는 매개변수: appId (필수)

이 호출은 크레딧 외에도 요금제에 포함됐거나 구매한 AI 가시성 측정 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/history

한 국가의 키워드 순위 기록입니다. 시리즈의 각 점은 [day, rank]입니다. rank가 null이면 그날 앱이 상위 결과에 없었다는 뜻이며, 순위가 나쁜 것과는 다릅니다. Pro 플랜.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country

curl "https://storelift.net/v1/apps/sbx-lumen/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/page

한 국가에서 앱 자체의 스토어 등록 정보 신호입니다(이름과 부제는 포함하지 않습니다). 버전, 앱 내 이벤트, 에디토리얼 노출, 유사 앱 선반, 스크린샷 세트(iOS)와 Google Play 페이지(정확한 설치 수, 평점 분포, 광고/앱 내 구입 표시, 차트 배지)를 반환합니다. ios.listingExtras에는 앱이 지원하는 언어, 별점 분포(1★~5★), 진행 중이거나 예정된 앱 내 이벤트, 프로모션 텍스트, 추천 앱 내 구입이 담깁니다. Free에서는 언어 수, 처음 5개 언어, 별점 분포가 오고 나머지가 몇 개인지는 locked가 알려 줍니다. timeline은 등록 정보에서 감지한 날짜별 변경 목록으로, 순위 변동을 가장 손쉽게 설명해 주는 단서입니다. measured=false는 페이지를 한 번도 읽지 않았다는 뜻이며, 빈 페이지와는 다릅니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country

curl "https://storelift.net/v1/apps/sbx-lumen/page?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/reviews

한 국가의 최근 리뷰입니다. list는 App Store 리뷰이고, android는 Google Play 리뷰입니다(기간이 더 짧음). 각각 본문, 평점, 날짜가 함께 나옵니다. newCount는 이전 측정 이후 들어온 리뷰 수입니다. 오래된 레코드에서는 null로 오므로 0이 아니라 알 수 없음으로 읽으세요. android: null은 해당 Play 페이지가 첫 측정을 기다리는 중이라는 뜻이고, 빈 목록은 그 페이지에 리뷰가 없다는 뜻입니다.

스코프

reviews:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country

curl "https://storelift.net/v1/apps/sbx-lumen/reviews?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/charts

한 국가의 App Store 차트 순위입니다. 목록별(무료 / 유료 / 매출, 전체와 카테고리 내) 현재 순위와 그 기록을 반환합니다. Google Play는 의도적으로 넣지 않았습니다. Google Play에는 공개된 인기 차트가 없어, 여기에 숫자를 넣으면 지어낸 값이 됩니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country

curl "https://storelift.net/v1/apps/sbx-lumen/charts?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/reviews/search

한 스토어프런트에서 한 앱의 리뷰를 텍스트, 별점, 앱 버전, 기간으로 검색해 최신순으로 반환합니다. 플랜의 리뷰 기간 안에서 전체 리뷰 아카이브로부터 최대 1,000행입니다. total은 일치한 건수이고, truncated는 요청한 것보다 더 많은 행이 일치했음을 알려 줍니다.

스코프

reviews:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/reviews/search?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/reviews/stats

한 스토어프런트에서 한 앱의 별점 분포, 평균, 1~2점 리뷰 비율과 함께 일별 추이(하루 건수와 평균), 버전별 분석을 반환합니다. 하락을 그 원인이 된 릴리스와 맞춰 볼 수 있습니다. 기본값은 최근 90일입니다.

스코프

reviews:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/reviews/stats?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/reviews/summary

한 스토어프런트에서 한 앱의 리뷰 AI입니다. 최근 리뷰의 요약과 그 안의 주제(불만, 요청, 칭찬)를 근거로 인용한 리뷰와 함께 반환합니다. 같은 날 같은 리뷰 묶음이면 저장된 요약을 한도 차감 없이 반환합니다. 새 요약은 월간 한도에서 리뷰 AI 크레딧 1개를 사용합니다(모든 플랜, Free는 맛보기 분량). 요약하기에 리뷰가 너무 적은 동안에는 개수와 함께 state: "too_few"를 반환합니다.

스코프

reviews:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country

이 호출은 크레딧 외에도 월간 제공량에서 리뷰 AI 크레딧 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/reviews/reply-draft

리뷰 하나에 대한 개발자 답글 초안을 해당 스토어프런트의 언어로 반환합니다. 리뷰의 평점과 본문은 Storelift에 저장된 리뷰에서 가져오므로, 초안은 리뷰어가 실제로 쓴 내용에 답합니다. note에는 답글에 담고 싶은 내용(수정 배포, 시도해 볼 설정 등)을 넣습니다. 초안만 반환합니다. 답글 게시는 확인 후 reply_review가 수행합니다. 리뷰 AI 크레딧 1개를 사용합니다.

스코프

reviews:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country

이 호출은 크레딧 외에도 리뷰 AI 크레딧 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/timeline

한 앱의 등록 정보에 생긴 날짜별 변경입니다. 스토어 페이지에서 읽은 새 버전, 스크린샷, 앱 내 이벤트, 피처드와 App Store Connect에서 읽은 키워드 필드 수정을 각각 전후의 키워드 순위 변동과 함께 반환합니다. 변경 전 마지막 측정과 변경 후 window일 이내 마지막 측정 사이에 오르거나 내리거나 새로 진입하거나 빠진 검색어, 그리고 가장 큰 변동 5개입니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/timeline?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/today

한 앱의 하루를 한 번의 응답으로 반환합니다. '오늘' 화면에 해당합니다. 연결된 소스의 구매·체험·갱신, 새 리뷰, 어제 대비 순위와 카테고리 변동, 내 앱 위로 새로 들어온 앱, 새 앱 내 이벤트, 그리고 어제의 App Store, Google Play, 순수익, 광고 수치를 각각 출처 소스와 함께 표시합니다. tz를 지정하면 '오늘'이 사용자의 하루가 됩니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수)

curl "https://storelift.net/v1/apps/sbx-lumen/today" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/competition

한 스토어프런트에서 키워드마다 몇 개의 앱이 경쟁하는지를, 두 개 이상의 앱에서 확인된 검색어에 대해 반환합니다. 기본값은 앱의 추적 키워드입니다. 추적하기 전에 후보를 세어 보려면 terms를 넘기세요. corpus는 집계의 바탕이 된 집합의 크기입니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/competition?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/rivals/{rivalId}

한 스토어프런트에서 내 앱의 경쟁 앱 하나입니다. 이름, 평점, 평가 수와 그 90일 기록(이름 변경은 등록 정보를 다시 썼다는 신호입니다), 그리고 순위에 오른 키워드와 각 키워드에서의 순위를 반환합니다. 키워드 목록은 월간 한도에서 키워드 스파이 1회를 사용하며 30일 동안 열려 있습니다. 한도를 모두 쓰면 응답은 locked: true와 함께 경쟁 앱 자체의 수치만 담습니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

이 호출은 크레딧 외에도 월간 제공량에서 키워드 스파이 조회 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/rivals/{rivalId}/adnetworks

경쟁 앱이 광고로 수익을 내는 방식입니다. 함께 일하는 광고 네트워크를 각각 DIRECT 또는 RESELLER 표시와 함께 반환합니다. 상태로 경우를 구분합니다. 찾은 네트워크, 광고 네트워크를 밝히지 않은 개발자(no_file), 이번에는 확인을 마치지 못한 경우(unreachable), 개발자 사이트가 없는 등록 정보(no_site) 중 하나입니다. 14일간 보관합니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · platform

curl "https://storelift.net/v1/apps/sbx-lumen/rivals/1000000001/adnetworks" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/rivals/{rivalId}/market

한 스토어프런트에서 경쟁 앱의 시장 데이터입니다. Google Play에서는 정확한 설치 수와 앱 내 구입 가격대, 그리고 두 번 측정한 뒤에는 그 사이의 설치 수를 반환합니다. App Store에서는 가격, 평가 수, 출시일, 앱 내 구입 판매 여부를 반환합니다. 요청 시 측정해 7일간 보관합니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수) · country · platform

curl "https://storelift.net/v1/apps/sbx-lumen/rivals/1000000001/market?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/storefront-audit

모든 App Store 스토어프런트에서의 iOS 등록 정보입니다. 앱이 판매되는 곳, 자국어 대신 대체 텍스트나 대체 스크린샷을 보여 주는 스토어프런트, 각 스토어프런트가 함께 색인하는 두 번째 로케일을 반환합니다. 마지막 스캔을 반환합니다. refresh: true는 마지막 스캔이 12시간보다 오래되었을 때 새 스캔을 시작하고 eta초와 함께 202로 응답합니다. 그 시간이 지난 뒤 다시 호출하세요. 전체 표는 Pro 이상에서 제공하며, Free는 미리보기를 받습니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수)

curl "https://storelift.net/v1/apps/sbx-lumen/storefront-audit" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/suggest

한 스토어프런트에서 한 앱의 새 키워드 아이디어를 해당 스토어프런트의 검색 언어로 반환합니다. 사람들이 스토어 검색창에 입력하는 1~3단어 검색어이며, 누가 검색하고 왜 이 앱이 그 필요에 맞는지 알려 주는 한 줄 이유가 붙습니다. 추적 키워드, 숨긴 키워드, 브랜드명은 제외됩니다. 월간 한도에서 AI 작성 크레딧 1개를 사용합니다(Pro 이상). 추적하기 전에 get_keyword_metrics로 아이디어를 측정하세요.

스코프

apps:read

크레딧

1

요금제

Pro

함께 받는 매개변수: appId (필수)

이 호출은 크레딧 외에도 월간 제공량에서 AI 작성 크레딧 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

POST /apps/{appId}/validate-listing

App Store 등록 정보 초안을 App Store Connect로 보내기 전에 점검합니다. 필드별 글자 수 제한, 키워드 필드에서 공백으로 낭비된 자리, 중복, 이름이나 부제에 이미 있는 단어, 브랜드명과 불필요한 단어, 이름/부제 간 중복, Apple 제품명과 가격 관련 단어, 텍스트가 해당 로케일의 언어와 문자로 쓰였는지, 그리고 앱의 추적 키워드 중 초안에서 빠진 것을 알려 줍니다. 아무것도 쓰지 않습니다. 점검할 필드만 넘기세요.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수)

curl -X POST "https://storelift.net/v1/apps/sbx-lumen/validate-listing" \
  -H "Authorization: Bearer $STORELIFT_API_KEY" \
  -H "content-type: application/json" \
  -d '{"locale":"en-US","name":"Lumen: Sleep Sounds","subtitle":"White noise and rain for sleep","keywords":"calm,relax,nap,baby,fan,ocean,lullaby"}'

GET /apps/{appId}/draft

등록 정보 초안(제목, 부제, 프로모션 텍스트, 설명)입니다. 한 스토어프런트에서 이 앱에 대해 측정한 키워드를 수요가 높은 순으로 반영해 만듭니다. 모든 필드에는 스토어 제한 대비 글자 수가 붙고, 심사 관련 점검 두 가지(제목 또는 부제의 Apple 제품명(App Store만 해당)과 가격 관련 표현)가 함께 제공됩니다. termsUsed는 초안의 바탕이 된 측정된 검색어이고, excluded는 아직 측정하지 않은 추적 검색어입니다. 스토어에는 아무것도 쓰지 않습니다. 쓰기는 update_listing이 합니다. AI 작성 크레딧 1개를 사용합니다(Pro 이상).

스코프

apps:read

크레딧

1

요금제

Pro

함께 받는 매개변수: appId (필수) · platform

이 호출은 크레딧 외에도 AI 작성 크레딧 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/localize

새 로케일용 App Store 등록 정보 전체(이름, 부제, 키워드 필드, 설명)를 앱의 원본 등록 정보를 바탕으로 작성합니다. 모든 키워드는 먼저 해당 스토어프런트에서 측정합니다. 첫 호출이 작성을 시작하고 pending으로 응답합니다(플랜의 등록 정보 작성 1회를 사용합니다. Free는 총 1회, Pro는 월 20회, Studio는 월 75회). 등록 정보가 돌아올 때까지 poll=true로 다시 호출하세요. shots=true를 주면 스크린샷 캡션도 같은 언어로 함께 돌아옵니다. 해당 앱에 대해 get_storefront_audit가 먼저 실행되어 있어야 합니다. App Store Connect에는 아무것도 쓰지 않습니다. 쓰기는 update_listing가 합니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수)

이 호출은 크레딧 외에도 요금제에 포함된 등록 정보 쓰기 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/shot-text

한 스토어프런트에서 App Store 스크린샷 처음 네 장에 들어 있는 캡션 텍스트를 반환합니다. Apple이 색인하는 것은 등록 정보 텍스트이므로, 이 텍스트는 검색 순위가 아니라 전환에 영향을 줍니다. 응답은 indexed: false로 이를 알려 줍니다. 스크린샷이 바뀔 때까지 보관합니다. 새로 읽으면 AI 작성 크레딧 1개를 사용합니다(Pro 이상).

스코프

apps:read

크레딧

1

요금제

Pro

함께 받는 매개변수: appId (필수)

이 호출은 크레딧 외에도 AI 작성 크레딧 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

GET /apps/{appId}/chart-movers

앱이 속한 카테고리 차트에서 누가 움직였는지 반환합니다. 상승·하락(3계단 이상), 신규 진입, 이탈한 앱을 이름과 함께 반환하고, 앱 자신과 선택한 경쟁 앱이 두 날짜에 각각 어디에 있었는지도 알려 줍니다. 카테고리는 앱의 차트 기록에서 가져옵니다. 다른 카테고리를 보려면 genre를 넘기세요. Pro 플랜.

스코프

apps:read

크레딧

1

요금제

Pro

함께 받는 매개변수: appId (필수) · country

curl "https://storelift.net/v1/apps/sbx-lumen/chart-movers?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}/featuring

Apple이 오늘 앱을 어디에 노출하는지 국가별로 반환합니다. 에디토리얼 카드(dedicated: true는 이 앱을 다룬 스토리, false는 컬렉션에 포함된 경우), 진행 중이거나 예정된 앱 내 이벤트, Apple의 You Might Also Like 선반, 피처드와 새 이벤트의 날짜별 기록입니다. country를 비워 두면 앱이 추적하는 모든 국가가 대상입니다.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수)

curl "https://storelift.net/v1/apps/sbx-lumen/featuring?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET /apps/{appId}

추적 중인 앱 하나를 플랫폼 ID, 국가, 국가별 추적 키워드, 최신 측정 스냅샷(국가별 키워드 표)과 함께 반환합니다. appId를 얻으려면 먼저 list_apps를 사용하세요.

스코프

apps:read

크레딧

1

요금제

Free

함께 받는 매개변수: appId (필수)

curl "https://storelift.net/v1/apps/sbx-lumen" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

GET /apps/{appId}/weekly-plan

이 앱의 이번 주 등록 정보 제안입니다. 대시보드의 '이번 주 할 일' 카드와 같은 목록이며, 효과가 큰 순으로 정렬됩니다. 제안은 엄격한 점검을 통과했을 때만 나타납니다. 키워드를 제목이나 부제에 넣는 것은 그 키워드가 앱이 속한 니치의 핵심이자 수요가 높은 검색어이고, 앱이 이미 4~15위에 있으며, 위에 있는 경쟁 앱들이 이름에 그 키워드를 담고 있고, 브랜드나 순위에 오른 단어를 빼지 않고도 들어갈 때뿐입니다. 니치 키워드나 롱테일 키워드는 자리가 있을 때에만, 많아야 키워드 필드까지 들어갑니다. 다른 카테고리, 다른 언어, 사용자가 거절한 키워드는 절대 나타나지 않습니다. 최근의 등록 정보 변경이 아직 자리 잡는 중이면 아무것도 제안하지 않습니다(settling이 언제까지인지 알려 줍니다). 각 작업에는 제안 문장, 현재 텍스트와 제안 텍스트, 추가하는 단어와 빼는 단어, 이유(측정된 사실), 감수해야 할 점, 신뢰도가 담깁니다. country가 없으면 모든 스토어프런트를 합치며, 같은 변경은 해당 국가들이 붙은 하나의 작업이 됩니다. 비어 있는 경우가 많으며, 이는 의도된 것입니다. Pro 플랜.

스코프

apps:read

크레딧

1

요금제

Pro

함께 받는 매개변수: appId (필수)

curl "https://storelift.net/v1/apps/sbx-lumen/weekly-plan?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"