본문 바로가기
개발가이드커머스앱 리뷰 조회

앱 리뷰 조회 API

명세 내보내기
OpenAPI 3.0.3Postman 컬렉션Markdown

iOS 앱의 정보(평점·평가 수·가격·장르)와 고객 리뷰를 한 번에 받습니다. 앱 ID 하나로 앱 개요와 최신 리뷰를 함께 확인할 때 씁니다.

POSThttps://apick.app/rest/app_reviews
인증
Bearer 키
요청 형식
form-data
응답
JSON
경로
1개

왜 앱 리뷰 조회인가

별점 하락, 리뷰 한 줄에서 먼저 잡아낸다

앱 마켓 리뷰를 매일 눈으로 넘기다 보면 불만은 이미 퍼진 뒤입니다. 앱 정보와 평점, 고객 리뷰를 정리된 JSON으로 받아 대시보드와 알림에 바로 꽂으세요.

도입 효과

  • 리뷰 확인 수작업이 사라진다
  • 불만 키워드를 출시 직후 포착
  • 경쟁 앱 평점 흐름까지 한눈에

이런 곳에서 많이 씁니다

  • 앱 운영팀 리뷰 모니터링 대시보드
  • 경쟁 앱 평점 비교 리포트 자동화
  • CS팀 불만 리뷰 실시간 알림
  • 앱 마케팅 대행사 월간 평판 보고서
가입하고 API 키 받기API 키 하나로 바로 호출 · 실패한 요청은 과금되지 않습니다

알아둘 점

이용 전 확인

성공한 조회 한 건당 30P가 차감됩니다. 실제 차감액은 응답의 api.cost에서 확인하세요. 입력 오류·앱 없음·리뷰를 받지 못한 경우처럼 실패한 호출은 과금되지 않습니다.

앱 ID는 앱 상세 주소 끝의 숫자입니다(예: …/app/앱이름/id362057947 의 362057947). id362057947처럼 앞에 붙은 id를 지우지 않고 보내도 됩니다.

리뷰는 최신순으로 페이지 단위로 제공됩니다. 오래된 리뷰는 page를 1부터 차례로 올려 받으며 최대 10페이지까지입니다. 전체 리뷰를 한 번에 내려받는 용도로는 쓸 수 없습니다.

국가마다 리뷰가 따로 쌓이므로 country로 국가를 고릅니다. 같은 앱이라도 국가를 바꾸면 리뷰 목록이 달라집니다.

응답 시간은 보통 5초 이내이고 최대 30초입니다. 요청 시간 제한을 35초 이상으로 잡으세요.

인증키는 서버 환경변수에 보관하고 공개 저장소·웹페이지에 넣지 마세요.

요청과 응답

API 요청
POST/rest/app_reviews
  • Bearer 인증
  • multipart/form-data
  • JSON 응답
요청 파라미터 3개 · 필수 1
파라미터
설명
appIdstring필수
조회할 iOS 앱의 숫자 ID입니다. 앱 링크의 /id 뒤 숫자를 사용하며, Android 패키지명과 다릅니다.
형식
^[0-9]{1,12}$
예시
362057947
countrystring선택
국가 코드 (기본 kr) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다.
형식
^[a-z]{2}$
예시
kr
pageinteger선택
리뷰 페이지 (기본 1, 최대 10) 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다.
응답 필드 33개
응답 필드
설명
dataobject
요청 처리 결과 묶음입니다. 조회한 값·작업 상태·오류 설명이 이 안에 들어 있으며, 실제 하위 필드 구성은 서비스마다 다릅니다. 값이 없으면 null·빈 배열·필드 생략 중 해당 서비스의 규칙을 따릅니다.
data.appIdstring
조회한 앱 고유 ID입니다. 요청에서 보낸 값이 그대로 돌아옵니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.countrystring
조회한 국가 코드입니다. 앱 정보·리뷰의 기준 국가입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.pageinteger
조회한 리뷰 페이지 번호입니다. 1부터 시작합니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요.
data.appobject
앱 정보 묶음입니다. 앱 이름·제공자·가격·평점·장르가 들어 있으며, 앱을 찾지 못하면 null입니다. null 허용.
data.reviewsarray
리뷰 목록입니다. 리뷰가 없으면 빈 배열이며, 페이지 단위로 제공되므로 다음 페이지는 page를 올려 요청합니다.
data.reviewCountinteger
이번 응답에 실제로 담긴 리뷰 수입니다. 앱 전체 리뷰 수와 다를 수 있습니다.
data.successinteger
업무 처리 결과 코드입니다. 1은 정상 결과, 0은 실패 또는 무료 응답입니다. 서비스에 따라 2·3처럼 추가 코드를 쓰므로 같은 응답의 status·msg·error 필드도 함께 확인하세요.
apiobject
API 호출 메타데이터입니다. 이번 요청의 서버 처리 성공 여부(api.success), 실제 차감 포인트(api.cost), 결제 기록 ID(api.pl_id)를 담습니다. 처리 시간(api.ms)은 응답에 포함된 경우에만 제공됩니다. 업무 결과는 data에서 확인합니다.
api.successboolean
API 서버가 이번 요청을 정상 처리했는지 여부입니다. true여도 업무 결과가 실패일 수 있으므로 data.success·data.status와 함께 판단합니다. 인증 실패·잘못된 입력·서버 오류 응답에서는 false입니다.
api.costinteger
이번 호출에서 실제로 차감된 포인트입니다. 유료 성공 응답에서만 단가만큼 차감되며, 실패·무료 조회·같은 요청의 멱등 재전송은 0입니다. 화면의 표시 단가와 실제 차감액이 다를 수 있으므로 정산은 이 값을 기준으로 합니다.
api.msinteger
서버가 요청을 받아 응답 본문을 만들기까지 걸린 처리 시간(밀리초)입니다. 네트워크 왕복 시간과 클라이언트 대기 시간은 포함되지 않습니다.
api.pl_idinteger
포인트 차감 기록 ID입니다. 차감이 발생한 호출에만 값이 있으며, 과금 내역을 문의할 때 이 번호를 사용합니다. 무과금 응답은 -1·null이거나 필드가 생략됩니다.
하위 필드 20개 더 보기
응답 필드
설명
data.app.appIdstring
조회한 앱 고유 ID입니다. 요청에서 보낸 값이 그대로 돌아옵니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.namestring
앱 표시 이름입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.sellerNamestring
앱 제공자(개발사) 이름입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.bundleIdstring
앱 번들 ID입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.priceinteger
앱 판매 가격입니다. 무료 앱은 0이며, 통화는 조회한 국가의 앱 마켓 기준입니다. null 허용.
data.app.currencystring
가격 통화입니다(예: KRW). 가격의 통화 코드입니다. 예: KRW, USD.
data.app.averageUserRatingnumber
앱의 평균 평점입니다. 평가가 하나도 없으면 null입니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. null 허용.
data.app.userRatingCountinteger
앱에 등록된 전체 평가 수입니다. 이번 응답의 리뷰 수와 다릅니다. 숫자로 오며, 단위·범위는 같은 응답의 다른 필드나 이 문서의 설명을 확인하세요. null 허용.
data.app.genresarray
앱 장르 목록입니다. 여러 장르에 속하면 두 건 이상 올 수 있습니다. 각 항목의 구성은 서비스에 따라 다르며, 값이 없으면 빈 배열입니다. 항목 수와 순서를 함께 확인하세요.
data.app.versionstring
현재 버전입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.releasedAtstring
현재 버전 출시 시각(ISO 8601)입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.artworkUrlstring
앱 아이콘 이미지 주소입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.app.urlstring
앱 상세 페이지 주소입니다. http·https로 시작하는 전체 URL입니다. 대상 페이지를 앱에서 바로 열 수 있으며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다.
data.reviews[].idstring
리뷰 고유 ID입니다. 같은 앱에서 리뷰를 중복 제거할 때 사용합니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.reviews[].authorstring
리뷰 작성자의 공개 표시 이름입니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.reviews[].ratinginteger
작성자가 남긴 별점입니다. 1~5 정수입니다. 평점입니다. 서비스별 만점 기준은 같은 문서의 설명을 확인하세요. null 허용.
data.reviews[].versionstring
리뷰를 작성할 때 사용한 앱 버전입니다. 버전 정보가 없으면 null이거나 생략됩니다.
data.reviews[].titlestring
리뷰 제목입니다. 제목 없이 본문만 남긴 리뷰는 빈 문자열일 수 있습니다.
data.reviews[].contentstring
리뷰 본문입니다. 줄바꿈이 포함될 수 있습니다. 문자열로 오며, 값이 없으면 빈 문자열이거나 필드가 생략됩니다. 같은 응답의 다른 필드와 함께 해석하세요.
data.reviews[].updatedstring
리뷰가 마지막으로 갱신된 시각입니다. ISO 8601 형식이며 시간대가 포함됩니다.
입력 조건·전송 규칙
항목
설정
메서드·주소
POST https://apick.app/rest/app_reviews
인증 헤더
Authorization: Bearer — 내 계정의 API 인증키
본문 형식
multipart/form-data
요청 예시

국내 기준으로 앱 정보와 첫 페이지 리뷰를 받는 예입니다. 성공 시 과금되는 실제 요청입니다.

다음 페이지는 page=2처럼 값을 올려 같은 요청을 보냅니다. 요금은 페이지마다 같습니다.

사용 예시

상황별로 보내는 값과 응답에서 확인할 값을 모았습니다. 언어 탭에서 그대로 복사해 쓸 수 있습니다.

예시 1. 국내 앱 정보와 최신 리뷰

앱 ID와 국가 코드로 앱 개요와 첫 페이지 리뷰를 받는 기본 요청입니다. country를 생략하면 kr입니다.

요청POST/rest/app_reviews
curl --fail-with-body --request POST 'https://apick.app/rest/app_reviews' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'appId=362057947' \
  --form-string 'country=kr'
  • data.app.averageUserRating과 userRatingCount로 평점을 표시합니다. 평가가 없으면 평점이 null입니다.
  • data.reviews[]는 최신순이며 data.reviewCount가 이번 응답의 리뷰 수입니다.
예시 2. 다른 나라 리뷰의 다음 페이지

해외 출시 앱의 반응을 볼 때 country를 바꾸고, 오래된 리뷰는 page를 올려 받습니다(최대 10).

요청POST/rest/app_reviews
curl --fail-with-body --request POST 'https://apick.app/rest/app_reviews' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'appId=362057947' \
  --form-string 'country=us' \
  --form-string 'page=2'
  • data.page가 요청한 페이지인지 확인합니다. 10보다 큰 값은 10으로 처리됩니다.
  • 요청한 페이지의 리뷰를 받지 못하면 오류 문구와 함께 과금되지 않습니다. page를 줄여 다시 요청하세요.
예시 3. 앱 주소의 id 표기를 그대로

앱 상세 주소 끝의 id362057947 같은 표기를 그대로 보내도 숫자 ID로 읽습니다.

요청POST/rest/app_reviews
curl --fail-with-body --request POST 'https://apick.app/rest/app_reviews' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --form-string 'country=kr' \
  --form-string 'appId=id362057947'
  • data.appId에는 숫자만 남은 앱 ID가 돌아옵니다. 저장할 때는 이 값을 쓰세요.
  • 없는 앱 ID는 HTTP 404이며 과금되지 않습니다.

응답 처리

HTTP 성공과 업무 결과를 구분하세요. 경로별 응답 필드와 예시는 위 요청과 응답에 함께 있습니다.

{
  "data": {
    "appId": "362057947",
    "country": "kr",
    "page": 1,
    "app": { "appId": "362057947", "name": "앱 이름", "sellerName": "제공자", "bundleId": "com.example.app", "price": 0, "currency": "KRW", "averageUserRating": 4.5, "userRatingCount": 1200, "genres": ["유틸리티"], "version": "3.2.0", "releasedAt": "2026-09-30T07:00:00Z", "artworkUrl": "https://example.com/icon.png", "url": "https://example.com/app/id362057947" },
    "reviews": [{ "id": "1", "author": "사용자", "rating": 5, "version": "3.2.0", "title": "좋아요", "content": "잘 씁니다", "updated": "2026-01-01T00:00:00-07:00" }],
    "reviewCount": 1,
    "success": 1
  },
  "api": { "success": true, "cost": 30, "ms": 320, "pl_id": 1234567 }
}

HTTP 200이고 data.error가 없으면 성공입니다. 평가가 하나도 없는 앱의 1페이지는 data.reviews가 빈 배열인 정상 응답(과금)입니다. 그 밖에 리뷰를 받지 못하면 성공 대신 아래 오류로 끝나며 과금되지 않습니다.

data.app이 null이어도 리뷰가 있으면 성공 응답입니다. 다음 페이지를 받을 때는 data.reviews[].id로 이미 저장한 리뷰를 건너뛰세요.

원문 응답 필드 표 보기
필드
타입
설명
data.appId
string
요청한 앱 ID(숫자만)입니다.
data.country
string
조회한 국가 코드(소문자)입니다.
data.page
integer
실제로 조회한 리뷰 페이지입니다. 범위를 벗어난 값은 1 또는 10으로 바뀌어 옵니다.
data.app
object
앱 정보입니다. 해당 국가에서 앱 정보를 찾지 못하면 null일 수 있습니다.
data.app.appId
string
앱 ID입니다.
data.app.name
string
앱 이름입니다.
data.app.sellerName
string
제공자 이름입니다.
data.app.bundleId
string
앱 번들 ID입니다.
data.app.price
number
판매 가격입니다. 무료는 0이고, 값이 없으면 null입니다.
data.app.currency
string
가격 통화입니다(예: KRW).
data.app.averageUserRating
number
평균 평점입니다. 평가가 없으면 null입니다.
data.app.userRatingCount
integer
평가 수입니다. 평가가 없으면 null 또는 0입니다.
data.app.genres[]
array
장르 이름 목록입니다.
data.app.version
string
현재 버전입니다.
data.app.releasedAt
string
현재 버전 출시 시각(ISO 8601)입니다.
data.app.artworkUrl
string
앱 아이콘 이미지 주소입니다.
data.app.url
string
앱 상세 페이지 주소입니다.
data.reviews[]
array
리뷰 목록(최신순)입니다.
data.reviews[].id
string
리뷰 ID입니다. 중복 저장을 막는 키로 씁니다.
data.reviews[].author
string
작성자 표시 이름입니다.
data.reviews[].rating
integer
별점 1~5입니다. 읽지 못하면 null입니다.
data.reviews[].version
string
리뷰를 쓴 시점의 앱 버전입니다. 없으면 빈 문자열입니다.
data.reviews[].title
string
리뷰 제목입니다.
data.reviews[].content
string
리뷰 본문입니다.
data.reviews[].updated
string
작성 시각입니다. 시간대가 붙은 ISO 8601 형식이 기본이며, 날짜로 해석해 저장하세요.
data.reviewCount
integer
이번 응답에 담긴 리뷰 수입니다. data.reviews 길이와 같습니다.
data.success
integer
과금 여부입니다. 성공하면 1, 실패하면 0입니다.
api.cost
integer
차감된 포인트입니다. 실패한 응답은 0입니다.
api.ms
integer
처리 시간(밀리초)입니다.
api.pl_id
integer
결제 기록 번호입니다. 문의할 때 함께 알려 주세요.

오류 코드

응답을 아래 순서로 확인하세요. 결과 유무와 과금 여부는 서로 다릅니다.

  1. HTTP 상태전송·인증·입력 오류
  2. api.successAPI 처리 여부
  3. data · result업무 결과와 오류 문구
  4. api.cost이번 요청의 과금
업무 실패 응답 data.error
  • 입력값이 맞지 않거나 대상 자료가 없거나 일시적으로 처리하지 못하면 data.error(사유 문구)와 data.success=0을 돌려줍니다. HTTP 상태는 사유에 따라 400·404·408·424 중 하나입니다.
  • 이때 api.cost는 0이며 과금되지 않습니다. data.error 문구를 그대로 기록하고 사용자에게 보여 주세요.
  • 입력 오류(400)는 값을 고친 뒤 다시 요청하세요. 408·424는 잠시 후 한 번 다시 시도하고, 같은 입력으로 짧은 간격의 자동 반복은 하지 마세요.
{
  "data": {
    "error": "입력값을 확인해 주세요.",
    "success": 0
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 5
  }
}
서비스 코드·조건

오류와 복구

아래 경우는 data.error로 응답하며 과금되지 않습니다(api.cost 0). 실패 응답은 표의 HTTP 상태 코드와 함께 옵니다. 입력을 고쳐야 하는 오류는 400, 앱이 없으면 404, 잠시 후 다시 시도할 오류는 424입니다. 화면에 보여 줄 안내는 본문의 data.error를 쓰세요.

상황
HTTP
data.error
해결
앱 ID 형식 오류
400
입력 항목이 잘못됐습니다. 앱 ID(숫자, 예: 362057947)를 입력해 주세요.
앱 상세 주소 끝의 숫자(12자리 이하)를 보냅니다. 앱 이름이나 번들 ID를 넣지 않았는지 확인합니다.
국가 코드 오류
400
입력 항목이 잘못됐습니다. 국가 코드(2자리, 예: kr)를 확인해 주세요.
kr·us처럼 영문 두 글자로 보내거나 생략합니다.
앱 없음
404
해당 앱을 찾을 수 없습니다. 앱 ID 와 국가 코드를 확인해 주세요.
앱 ID를 확인하고, 그 나라에 출시된 앱인지 country를 바꿔 확인합니다.
1페이지 리뷰를 받지 못함
424
앱 리뷰를 일시적으로 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.
잠시 후 같은 요청을 다시 보냅니다.
2페이지 이후 리뷰를 받지 못함
424
요청한 페이지의 리뷰를 가져오지 못했습니다. 리뷰가 그보다 적거나 일시적인 문제일 수 있으니 page 를 줄이거나 잠시 후 다시 시도해 주세요.
리뷰가 그 페이지까지 없을 수 있으니 page를 줄입니다. 바로 앞 페이지가 받아졌다면 잠시 후 다시 시도합니다.
일시적 조회 실패
424
앱 리뷰 정보를 가져오지 못했습니다. 잠시 후 다시 시도해 주세요.
잠시 후 같은 요청을 다시 보냅니다.
인증·포인트 오류 result.error 문구
코드
HTTP
의미·조치
유효하지 않은 API키 입니다.
401
Authorization: Bearer 헤더의 인증키를 확인하세요.
허용되지 않은 IP주소 입니다.
401
마이페이지의 허용 IP 설정과 요청 서버 IP를 확인하세요.
비활성화된 계정입니다.
401
계정 이용 상태를 고객지원으로 문의하세요.
사용 가능한 포인트이 부족합니다.
200
HTTP 200이어도 result.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.
인증 정보를 확인할 수 없습니다.
424
일시적인 확인 실패입니다. 잠시 후 다시 시도하세요.
폼 입력 오류 error.code
코드
HTTP
의미·조치
FORM_DATA_INVALID
400
필드 이름·값의 타입·배열 인덱스를 확인하세요. 인덱스는 0부터 연속으로 사용합니다.
FORM_DATA_FIELD_CONFLICT
400
같은 값과 중첩 경로를 동시에 지정하지 마세요.
MULTIPART_LIMIT_OR_PARSE_ERROR
400·413
boundary·파일 크기·필드 개수를 확인하세요. 서비스별 제한이 우선 적용됩니다.

요금·이용 조건

기본 요금기본 단가 30P · 건당

실제 차감 금액은 응답의 api.cost로 확인하세요. 상세 요금은 요금정책에서 볼 수 있습니다.

연동 팁

  • 요청 예제의 오류 처리 포함 모드는 시간 제한과 업무 실패 판정을 함께 보여줍니다.
  • 인증키는 서버 환경변수에 두고 브라우저·앱에 넣지 마세요.
  • HTTP 성공과 업무 결과를 구분하고, 실패 응답의 오류 문구를 그대로 기록하세요.
추가 예제·서비스별 연동 안내

호출 예시

같은 요청을 JavaScript와 Python으로 옮긴 예시입니다. 키는 환경변수 APICK_API_KEY 에서 읽습니다.

JavaScript 예시
Python 예시

개발가이드 검색

API 이름·경로·파라미터·오류 코드로 찾을 수 있습니다.

표시 가격은 기본 단가입니다. 상세 과금 조건은 각 가이드에서 확인하세요.