Hive 엔드포인트

내가 추적하든 아니든, Storelift 네트워크가 측정하는 모든 앱과 시장입니다. Hive Explorer에 포함됩니다.

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

GET `/rank-check`

한 스토어프런트에서 임의의 검색어에 대한 내 앱의 실시간 순위를 스토어가 지금 보여 주는 그대로 반환합니다. 해당 검색어를 추적하고 있지 않아도 됩니다. 상태로 경우를 구분합니다. ranked는 순위와 바로 위의 앱들, absent는 상위 결과(앱이 그곳에서 판매되지만 그 결과 밖에 있음), not_in_store는 앱이 해당 스토어프런트에서 판매되지 않음을 뜻합니다.

스코프: apps:read
크레딧: 10
요금제: Free

매개변수	위치	타입	설명
`app`필수	query	string	App Store 링크 또는 ID, 혹은 Google Play 링크 또는 패키지 이름
`term`필수	query	string	검색어, 예: habit tracker
`cc`	query	string	스토어프런트 코드, 예: us
`platform`	query	ios \| android	선택 사항. 앱 링크에서 읽습니다

curl "https://storelift.net/v1/rank-check?app=us&term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/keyword-difficulty`

한 스토어프런트에서 App Store 검색어 하나의 수요와 난이도 입력값입니다. 수요(demand)와 연관 검색, 평가 수와 제목에 검색어가 있는지 여부가 붙은 상위 결과, 그중 가장 큰 평가 수와 평가 수 중앙값, 결과의 깊이를 반환합니다. thin은 결과가 10개 미만인 검색어를, zayifEslesme는 스토어가 느슨하게 매칭하는 검색어를 표시합니다. Free는 계정이 해당 스토어프런트에서 추적하는 검색어를, Pro 이상은 모든 검색어를 읽을 수 있습니다.

스코프: apps:read
크레딧: 10
요금제: Free

매개변수	위치	타입	설명
`term`필수	query	string	검색어, 예: habit tracker
`cc`	query	string	스토어프런트 코드, 예: us

curl "https://storelift.net/v1/keyword-difficulty?term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/find`

Storelift가 측정하는 인기 차트 전체에서 앱을 찾습니다. 카테고리, 스토어프런트, 차트(최고 매출, 인기 무료, 인기 유료 또는 인기 iPad), 순위 범위, 최초 확인일, 이름 또는 개발자, 그리고 월 수익, 월 다운로드, 30일 성장률로 필터링합니다. estimates: true를 넘기면 각 행의 월 수익과 다운로드를 Hive에서 각각 하나의 수치로, 그 수치의 날짜와 함께 받습니다. 수익, 다운로드 또는 성장률 필터를 설정하면 Hive에 아직 수치가 없는 앱은 제외되고 noEstimate에 집계됩니다. 목록은 20크레딧이며, 수치를 포함하거나 수익·다운로드·성장률 필터를 쓰면 반환된 행마다 50크레딧이 추가됩니다. 응답에는 최초 확인 색인이 시작된 날인 coverage가 담기므로, 읽는 모든 날짜는 색인된 날입니다.

스코프: hive:read
크레딧: 20
요금제: Hive Explorer

매개변수	위치	타입	설명
`genre`	query	string	Apple 장르 ID 최대 3개, 쉼표로 구분, 예: 6007,6012
`country`	query	string	스토어프런트 코드 최대 5개, 쉼표로 구분, 예: us,gb
`kind`	query	string	grossing, free, paid 또는 ipad(앱이 올라 있는 차트)
`released`	query	number	최근 N개월 이내에 처음 확인됨
`rankMin`	query	number	최고 차트 순위가 이 값 이상
`rankMax`	query	number	최고 차트 순위가 이 값 이하
`revenueMin`	query	number	월 총수익이 이 값 이상(USD)
`revenueMax`	query	number	월 총수익이 이 값 이하(USD)
`downloadsMin`	query	number	월 다운로드가 이 값 이상
`downloadsMax`	query	number	월 다운로드가 이 값 이하
`growthMin`	query	number	30일 변화가 이 값 이상, 퍼센트(예: 20)
`growthMax`	query	number	30일 변화가 이 값 이하, 퍼센트
`text`	query	string	앱 이름 또는 개발자 이름으로 매칭
`publisher`	query	string	market_publisher에서 얻은 개발자 ID
`estimates`	query	boolean	true이면 모든 행에 월 수익과 다운로드를 추가합니다(행당 50크레딧)
`limit`	query	number	페이지당 행 수, 기본값 50, 최대 200
`page`	query	number	결과 페이지, 기본값 1

curl "https://storelift.net/v1/hive/find?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/charts`

Storelift가 마지막으로 측정한 인기 차트 하나입니다. 스토어프런트, 목록 종류, 선택적 카테고리에 대한 순위순 앱 ID를 읽은 날짜와 함께 반환합니다. estimates: true를 넘기면 각 순위의 월간 값(최고 매출에서는 수익, 인기 무료에서는 다운로드)과 10위, 50위, 100위에 진입하는 데 필요한 수준을 반환합니다. 목록은 10크레딧이며, estimates: true를 쓰면 반환된 행마다 50크레딧이 추가됩니다. App Store만 해당합니다. Google Play에는 공개된 인기 차트가 없어, 숫자를 넣으면 지어낸 값이 됩니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`kind`	query	string	free, paid 또는 grossing
`genre`	query	string	Apple 장르 ID, 예: 6007. 전체 차트는 생략
`limit`	query	number	행 수, 최대 100

함께 받는 매개변수: country

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

샌드박스에서 열기

샘플 응답

GET `/hive/movers`

인기 차트 하나에서 N일 전의 같은 차트와 비교해 누가 오르고, 내리고, 들어오고, 나갔는지 반환합니다. measured는 비교 대상 날짜의 데이터가 확보되어 있음을 알려 주므로, 읽는 모든 변동폭은 측정된 두 날짜 사이의 값입니다. 나간 앱은 오늘 차트 밖에 있으므로 변동폭 대신 마지막 순위를 담습니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`kind`	query	string	free, paid 또는 grossing
`genre`	query	string	Apple 장르 ID. 전체 차트는 생략
`days`	query	number	N일 전과 비교, 최대 90
`limit`	query	number	방향별 행 수, 최대 100

함께 받는 매개변수: country

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

GET `/hive/new`

인기 차트에서 처음 확인된 앱을 최신순으로, 각 앱의 개발자와 함께 반환합니다. daysCovered는 요청한 일수 중 색인이 보유한 일수를 알려 주므로, 읽는 모든 최초 확인일은 색인된 날입니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`days`	query	number	N일 전까지 조회, 최대 30
`country`	query	string	스토어프런트 코드. 모든 스토어프런트는 생략
`limit`	query	number	행 수, 최대 200

curl "https://storelift.net/v1/hive/new?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/publisher/{publisherId}`

한 개발자의 앱 중 차트에서 확인된 모든 앱을 각각 처음 확인된 날짜와 함께 반환합니다. 그 개발자의 앱 중 차트에 오른 적 없는 앱은 여기에 없습니다. 존재하는 것이 아니라 측정한 것을 나열합니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`publisherId`필수	path	string	개발자 ID, 예: market_new_apps에서 얻은 값

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

GET `/hive/resolve`

어떤 앱이든 ID를 찾습니다. 이름이나 개발자로(해당 스토어프런트의 상위 일치 결과, 개발자·카테고리·평점·평가 수 포함), 또는 App Store / Google Play 링크, App Store ID 자체, 패키지 이름으로 찾을 수 있습니다. 이름만 알고 있을 때 hive_app_details, hive_similar_apps, hive_app_reviews보다 먼저 사용하세요.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`q`필수	query	string	앱 이름, 개발자 이름, 스토어 링크, App Store ID 또는 패키지 이름
`limit`	query	number	결과 수, 최대 25(기본값 10)

함께 받는 매개변수: country

curl "https://storelift.net/v1/hive/resolve?q=sleep&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/similar/{appId}`

어떤 앱이든 스토어 자체의 유사 앱 선반(Apple의 You Might Also Like, Google의 Similar apps)을 선반 순서대로 반환합니다. 각 앱의 카테고리, 이름, 개발자와 선반을 읽은 날짜가 붙습니다. 선반에 놓인 카테고리를 보면 스토어가 그 앱을 어떤 무리에 두는지 알 수 있습니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`appId`필수	path	string	App Store ID(예: 570060128) 또는 Google Play 패키지 이름
`country`	query	string	스토어프런트 코드, 예: us(비워 두면 어느 스토어프런트에서든 가장 최근에 읽은 선반)

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

GET `/hive/reviews/{appId}`

한 스토어프런트에서 어떤 앱이든 최근 리뷰를 최신순으로 반환합니다. 별점, 제목, 본문, 버전, 날짜와 반환된 행의 별점 분포가 포함됩니다. 리뷰어 이름은 제외됩니다. Hive에 아직 없는 앱은 첫 호출 때 추가됩니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`appId`필수	path	string	App Store ID(예: 570060128) 또는 Google Play 패키지 이름
`limit`	query	number	리뷰 수, 최대 200(기본값 50)

함께 받는 매개변수: country

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

POST `/hive/keywords/{term}/metrics/measure`

저장된 값이 없거나 오래되었을 때, 한 스토어프런트에서 키워드 하나의 인기도와 난이도(또는 그중 하나) 측정을 시작합니다. 최신 값이나 확인된 부재는 새 작업 없이 반환합니다. 이미 실행 중인 작업에 합류하는 요청은 일일 측정 단위를 쓰지 않으며, 새 작업을 시작하는 요청은 워크스페이스의 일일 Hive 측정 한도에서 1단위를 사용합니다. 두 지표는 서로 독립적이어서, 한 소스가 실패해도 유효한 다른 지표는 응답에 남습니다. wait(0–20초)는 결과가 저장될 때까지 호출을 열어 둡니다. 202는 아직 실행 중이라는 뜻이며, 나중에 hive_keyword_metrics로 읽으세요. 옵트인 방식의 hive:measure 권한 범위가 필요합니다. API 키에서 선택하거나 OAuth로 연결할 때 따로 승인합니다. iOS 전용.

스코프: hive:measure
크레딧: 50
요금제: Hive Explorer

매개변수	위치	타입	설명
`term`필수	path	string	정확한 키워드, 예: habit tracker
`country`	body	string	스토어프런트 코드, 예: us(기본값 us)
`platform`	body	string
`metrics`	body	array	측정할 지표(기본값은 둘 다)
`wait`	body	number	저장된 결과를 기다릴 초, 0–20(생략하면 이 도구는 15를 보내며, HTTP API 기본값은 0)

새 작업을 시작하면 워크스페이스의 일일 Hive 측정 한도에서 하나를 쓰므로, 여기에는 복사할 명령이 없습니다.

요청 본문

{"country":"us","platform":"ios","metrics":["popularity","difficulty"],"wait":15}

GET `/hive/apps/{id}`

어떤 앱이든 네트워크가 가장 최근 날짜에 측정한 스토어 세부 정보입니다. 이름, 평가 수, 평점, 버전, 가격, 배포 상태, 배지, 앱 내 구입 수를 반환합니다. App Store 앱에서는 listingExtras에 지원 언어, 별점 분포(1★~5★), 진행 중이거나 예정된 앱 내 이벤트, 프로모션 텍스트, 추천 앱 내 구입이 자체 measuredAt과 함께 담깁니다. 측정 전이면 null입니다. not_measured는 앱을 추가해야 할 스토어프런트를 알려 줍니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`id`필수	path	string	App Store ID(5–12자리) 또는 Google Play 패키지 이름.

함께 받는 매개변수: country

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

샌드박스에서 열기

샘플 응답

GET `/hive/keywords/{term}/ranks`

네트워크가 측정하는 모든 키워드의 상위 결과를 날짜별로 반환합니다. 한 번의 호출이 1,000행을 넘지 않도록 top이 크면 days가 줄어듭니다. 7일까지 10크레딧, 30일까지 20, 90일까지 40입니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입
`term`필수	path	string
`top`	query	integer
`days`	query	integer

함께 받는 매개변수: country · platform

curl "https://storelift.net/v1/hive/keywords/sleep/ranks?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET `/hive/keywords/{term}/metrics`

정확히 일치하는 키워드 하나와 스토어프런트에 대해 기존 Hive 관측값을 읽습니다. 인기도는 1~100 사이의 정수이고, 난이도는 0~100 사이의 점수입니다. 없는 데이터는 null로 남습니다. 각 지표에는 자체 근거, 소스 시각, 최신성, 마지막 시도 상태가 붙습니다. 이 GET은 소스 요청이나 측정 작업을 시작하지 않습니다. Hive Explorer 전체 제품이 필요하며, Android는 명시적으로 지원하지 않습니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`term`필수	path	string	NFC로 정규화하고, 앞뒤 공백을 제거하고, 소문자로 바꾼 값. 내부 공백은 그대로 구분됩니다.
`platform`	query	ios	기본값 ios

함께 받는 매개변수: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET `/hive/keywords/{term}/metrics/history`

키워드의 저장된 일별 기록을 읽습니다. 날짜마다 기록된 검색 결과, 난이도 점수, Apple 인기도입니다. 과거 난이도 값은 기록된 그대로 유지됩니다. 실패했거나 불완전한 날은 그렇게 표시됩니다. 저장된 레코드가 없는 날은 0도, 확인된 부재도 아닙니다. 같은 keyword, storefront, days로 pagination.nextCursor를 따라가세요. 각 시리즈는 따로 페이지가 나뉘며 페이지당 최대 200개 레코드입니다. 이 GET은 저장된 기록만 읽으며 측정을 시작하지 않습니다. Hive Explorer 전체 제품이 필요하며, Android는 명시적으로 지원하지 않습니다. 7일까지 10크레딧, 30일까지 20, 90일까지 40입니다.

스코프: hive:read
크레딧: 20
요금제: Hive Explorer

매개변수	위치	타입	설명
`term`필수	path	string	NFC로 정규화하고, 앞뒤 공백을 제거하고, 소문자로 바꾼 값. 내부 공백은 그대로 구분됩니다.
`platform`	query	ios	기본값 ios
`days`	query	integer	오늘을 포함한 UTC 달력 일수. 인기도 리비전은 소스의 주 시작일이 이 범위에 드는 것으로 선택됩니다.
`cursor`	query	string	바로 이 쿼리의 pagination.nextCursor에서 받은 불투명한 연속 토큰.

함께 받는 매개변수: country

curl "https://storelift.net/v1/hive/keywords/sleep/metrics/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET `/hive/spy/{id}`

네트워크가 한 앱에 대해 측정한 모든 키워드를 순위와 함께 반환합니다. 모든 호출은 크레딧으로 결제되며, 보여 줄 키워드가 없는 앱은 1크레딧입니다.

스코프: hive:spy
크레딧: 200
요금제: Hive Explorer

매개변수	위치	타입	설명
`id`필수	path	string	App Store ID(5–12자리) 또는 Google Play 패키지 이름.

함께 받는 매개변수: country · platform

curl "https://storelift.net/v1/hive/spy/1000000104?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET `/hive/estimate/{id}`

모든 App Store 앱의 전 세계 월 수익과 다운로드입니다. 각각 하나의 수치(value, 앱이 그 금액에 못 미치면 under)와 포함된 시장 수를 반환합니다. 모든 앱에 답이 나옵니다. Hive는 이미 알고 있습니다. 앱에 대한 첫 요청은 읽기를 시작하고 eta초와 함께 202로 응답합니다. 수치는 500크레딧, 대기 중 응답은 1크레딧입니다.

스코프: hive:estimate
크레딧: 500
요금제: Hive Explorer

매개변수	위치	타입	설명
`id`필수	path	string	App Store ID.

함께 받는 매개변수: country

curl "https://storelift.net/v1/hive/estimate/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

샌드박스에서 열기

샘플 응답

GET `/hive/gap`

최대 5개 앱의 키워드 목록을 키워드당 한 행으로 나란히 보여 줍니다. 각 앱의 순위, 그 키워드에 순위가 있는 앱 수, 빠진 앱을 알 수 있습니다. 비교하는 앱당 200크레딧이며, 색인에 없는 앱은 과금되지 않습니다. Explorer에 포함됩니다.

스코프: hive:spy
크레딧: 400
요금제: Hive Explorer

매개변수	위치	타입	설명
`ids`필수	query	string	쉼표로 구분한 앱 ID, 2개 이상.

함께 받는 매개변수: country · platform

curl "https://storelift.net/v1/hive/gap?ids=1000000001,1000000104&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/research`

시드 키워드를 입력하면 관련된 App Store 검색어를 받습니다. 각각 Apple 인기도(관측된 경우 1–100, 없는 값은 null로 유지), 난이도(0–100), 순위에 오른 앱 수, 상위 10개 앱이 붙습니다. 지표 근거는 측정값, 확인된 부재, 대기 중인 작업, 소스 오류를 구분합니다. 측정이 진행 중인 행에는 state: "pending"이 붙습니다. 결과를 읽으려면 요청을 다시 보내세요. App Store가 검색어의 철자를 고친 경우 해당 행의 spell에 고쳐진 검색어가 들어갑니다. 앱이 필요 없습니다. Explorer에 포함됩니다.

스코프: hive:read
크레딧: 50
요금제: Hive Explorer

매개변수	위치	타입	설명
`seed`필수	query	string	시드 키워드.
`compare`	query	string	추가 스토어프런트 최대 5개, 쉼표로 구분(예: de,fr): 각 스토어프런트에서 같은 검색어의 인기도, 난이도, 앱 수.

함께 받는 매개변수: country

curl "https://storelift.net/v1/hive/research?seed=us&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

GET `/hive/landscape`

스토어프런트의 인기 무료 목록으로 본 카테고리 지형입니다. 상위 10개 앱의 평가 수 장벽, 평점 중앙값, 이름 길이, 출시와 업데이트의 최신성, 언어, 크기, 여러 앱을 가진 개발자를 반환합니다. 각 카테고리에는 자체 측정일이 붙습니다.

스코프: hive:read
크레딧: 10
요금제: Hive Explorer

매개변수	위치	타입	설명
`genre`	query	string	App Store 장르 ID(예: 6014) 또는 카테고리 키(all, games, entertainment, photo-video, productivity, health-fitness, education, lifestyle, finance, social-networking). 측정된 모든 카테고리를 보려면 생략하세요.

함께 받는 매개변수: country

curl "https://storelift.net/v1/hive/landscape?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"

Hive 엔드포인트

GET /rank-check

GET /keyword-difficulty

GET /hive/find

GET /hive/charts

GET /hive/movers

GET /hive/new

GET /hive/publisher/{publisherId}

GET /hive/resolve

GET /hive/similar/{appId}

GET /hive/reviews/{appId}

POST /hive/keywords/{term}/metrics/measure

GET /hive/apps/{id}

GET /hive/keywords/{term}/ranks

GET /hive/keywords/{term}/metrics

GET /hive/keywords/{term}/metrics/history

GET /hive/spy/{id}

GET /hive/estimate/{id}

GET /hive/gap

GET /hive/research

GET /hive/landscape

GET `/rank-check`

GET `/keyword-difficulty`

GET `/hive/find`

GET `/hive/charts`

GET `/hive/movers`

GET `/hive/new`

GET `/hive/publisher/{publisherId}`

GET `/hive/resolve`

GET `/hive/similar/{appId}`

GET `/hive/reviews/{appId}`

POST `/hive/keywords/{term}/metrics/measure`

GET `/hive/apps/{id}`

GET `/hive/keywords/{term}/ranks`

GET `/hive/keywords/{term}/metrics`

GET `/hive/keywords/{term}/metrics/history`

GET `/hive/spy/{id}`

GET `/hive/estimate/{id}`

GET `/hive/gap`

GET `/hive/research`

GET `/hive/landscape`