제품 검토 API 쿼리 대기열에 ASIN/ISBN 추가
최근 Amazon의 변경 사항으로 인해 Products Review API를 더 이상 사용할 수 없습니다.
제품 검토 쿼리 대기열에 ASIN/ISBN을 추가하라는 요청입니다. 제품 리뷰 API는 사용자 정의 쿼리 매개변수를 기반으로 결과를 필터링하는 기능을 통해 제품 리뷰를 쿼리합니다.
한정
API는 필터 조합당 최대 100개의 리뷰만 검색할 수 있습니다.
신용공제
데이터를 성공적으로 검색한 후 1회 크레딧 공제(제품 리뷰 페이지당). 검색에 성공하면 제품 리뷰 5페이지에 5크레딧이 소모됩니다.
요청
| URI | /api/query/reviews/{ASIN/ISBN}?domain={도메인}&secretKey={secretKey} | {ASIN/ISBN} – 필수 – 추적 목록에 추가할 ASIN 또는 ISBN
{도메인} – 선택 사항 – 유효한 값이 지정되지 않은 경우 기본값은 www.amazon.com입니다. [ http://www.amazon.com,/www.amazon.com ] {위치} – 선택 사항 – Amazon에 표시된 대로 위치별로 리뷰를 필터링합니다. 예('미국', '멕시코', '영국' 등) {에서 날짜} – 선택 사항 – 지정된 날짜 이후 게시된 리뷰를 필터링합니다(유효한 패턴 “yyyy-MM-dd”) {dateto} – 선택 사항 – 지정된 날짜까지 게시된 리뷰를 필터링합니다(유효한 패턴 “yyyy-MM-dd”) {확인된 구매만} – 선택사항 – 검증된 구매 리뷰만 필터링합니다(유효값: "true" 또는 "false") {평가} – 선택 사항 – 별점으로 리뷰를 필터링합니다(유효한 값: “1”, “2”, “3”, “4”, “5”). {최근} – 선택 사항 – true인 경우 가장 최근의 상위 10개 리뷰만 가져옵니다. |
| 예시 | /api/query/reviews/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx&location=Mexico&datefrom=2021-01-01&dateto=2021-12-31&verifiedpurchaseonly=true&rating=5&latestonly=true | |
응답
| 헤더 | |
| 미디어 종류 | 응용 프로그램 / json |
| JSON 데이터 |
JSON
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}주의 사항: 콜백 중에 Rid를 사용하여 콜백 데이터를 원래 요청 호출에 연결할 수 있습니다.
제품 리뷰 문의 콜백
제품 리뷰 문의 콜백 요청
| URI | 예: https://your.server.com/amzpecty_result | {환경설정 페이지에 URL을 제공하세요.} URL은 SSL을 활성화해야 합니다. AMZPECTY-API-SECRET-KEY(헤더 이름) – 콜백 서버가 요청 원본을 검증하기 위해 비밀 키 헤더가 포함됩니다. |
| 미디어 종류 | 응용 프로그램 / json |
제품 리뷰 쿼리 콜백 JSON 샘플 데이터
| 헤더 | |
| 미디어 종류 | 응용 프로그램 / json |
| JSON 데이터 |
JSON
{
"status": "OK",
"responsefor": "productreviews",
"allowed": 108974,
"dailyAllowed": 9903,
"messageId": null,
"message": null,
"data": {
"asin": "B01M5IK8M9",
"searchStatus": "completed",
"reviewPagesScanned": 4,
"requestFilters": {
"location": "United States",
"verifiedPurchaseOnly": true,
"fromDate": "Jan 01, 2021",
"toDate": "Dec 31, 2021",
"starRating": "5"
},
"totalReviews": 21,
"totalVerifiedPurchase": 21,
"reviewLocations": [
{
"location": "United States",
"reviewCount": 21
}
],
"ratings": [
{
"rating": "5.0 out of 5 stars",
"reviewCount": 21
}
],
"reviews": [
{
"reviewId": "R5N2Q27S1WE1P",
"customerName": "Spirit_Child",
"customerProfileLink": "https://www.amazon.com/gp/profile/amzn1.account.AFE7FQ7FOLUVIUTTUKVF3MVMUPFQ/ref=cm_cr_getr_d_gw_btm?ie=UTF8",
"customerProfileAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
"reviewTitle": "I love it!",
"reviewBody": "It delivered on time & it’s what I was expecting!!",
"reviewLocation": "United States",
"reviewDate": "Dec 22, 2021",
"verifiedPurchase": true,
"variant": "Size: Standard",
"starRating": 5,
"starRatingString": "5.0 out of 5 stars"
}
]
},
"rid": "628c4494e4b06e3bbeaa8b5b",
"dateProcessed": 1653359777214,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}제품 검토 쿼리 콜백 응답 JSON 속성
| 속성 이름 | 세부 정보 |
|---|---|
| 지위 | 요청 상태입니다. |
| 응답 | 제품 변형 쿼리 결과의 "productvariations" 값 |
| 수 | 현재 허용되는 요청 수입니다. 매월 재설정됩니다. |
| 매일 허용됨 | 현재 허용되는 일일 요청 수입니다. 매일 재설정됩니다. |
| 메시지 ID | 메시지의 ID입니다(있는 경우). |
| 메시지 | 실제 메시지(있는 경우) 참고해주세요 오류 메시지. |
| 제거 | 요청 ID입니다. 이는 이 응답을 원래 요청과 일치시키는 데 사용될 수 있습니다. |
| 처리된 날짜 | 요청이 처리된 날짜(Unix 시간 형식)입니다. |
| 도메인 | 대상 Amazon 도메인. |
| 총 공제된 크레딧 | 이 필드는 이 요청을 이행하는 데 사용된 Amzpecty API 크레딧 수를 나타냅니다. |
| 데이터.아신 | 상품의 ASIN입니다. |
| 데이터. 검색상태 | 검색 상태입니다. [ “진행 중”, “완료”, “오류”] |
| 데이터. 검토페이지스캔됨 | 스캔된 리뷰 페이지 수 |
| 데이터. 요청 필터 | 이 쿼리 요청에 대해 사용자가 필터를 지정했습니다. |
| 데이터. 요청 필터. 위치 | 위치 필터. [Amazon에 표시된 '미국', '멕시코' 등] |
| 데이터. 요청 필터. 확인구매만 | true – 확인된 구매만 반환 |
| 데이터. 요청 필터. 보낸 날짜 | 필터의 날짜를 검토합니다. [“yyyy-MM-dd” 예: “2021-01-01”] |
| 데이터. 요청 필터. 오늘까지 | 필터링할 검토 날짜입니다. [“yyyy-MM-dd” 예: “2021-12-31”] |
| 데이터. 요청 필터. 별점 매기기 | 별점 필터 [“1”, “2”, “3”, “4”, “5”] |
| data.total리뷰 | 총 리뷰 개수가 계산됩니다. |
| 데이터. 총 확인된 구매 | 확인된 총 구매 리뷰 수입니다. |
| 데이터. 리뷰위치[] | 해당 리뷰 수가 포함된 위치 목록 |
| 데이터. reviewLocations[n].location | 리뷰 위치 |
| 데이터. reviewLocations[n].reviewCount | 리뷰 위치 수 |
| 데이터. 평점 [] | 해당 등급 개수가 포함된 등급 목록 |
| 데이터. 등급[n].등급 | 리뷰 평점 |
| 데이터. 평점[n].reviewCount | 리뷰 평점 수 |
| 데이터. 리뷰[] | 해당 정보 세부정보가 포함된 사용자 리뷰 목록 |
| data.reviews[n].reviewId | 리뷰 ID |
| 데이터.리뷰[n].고객이름 | 리뷰 고객 이름 |
| 데이터.리뷰[n].customerProfileLink | 리뷰 프로필 링크 |
| data.reviews[n].customerProfileAvatar | 리뷰 프로필 아바타 링크 |
| 데이터.리뷰[n].reviewTitle | 리뷰 제목 |
| 데이터.리뷰[n].reviewBody | 리뷰 본문 |
| data.reviews[n].reviewLocation | 리뷰 위치 |
| data.reviews[n].reviewDate | 검토 날짜 |
| 데이터.리뷰[n].verifiedPurchase | 리뷰 확인 구매 플래그(확인된 경우 'true') |
| 데이터.리뷰[n].variant | 리뷰 제품 변형 |
| data.reviews[n].starRating | 리뷰 별점 |
| 데이터.리뷰[n].starRatingString | 문자열 형식의 리뷰 별점 |
ASIN/ISBN으로 제품 리뷰 결과 받기
ASIN/ISBN별 최신 제품 리뷰 결과를 얻기 위한 요청입니다.
신용공제
Get 호출에 대한 0(영) 크레딧 공제.
요청
| URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={도메인}&secretKey={secretKey} | {ASIN/ISBN} - 최신 추적 목록을 가져올 ASIN {domain} - 선택 사항 - 유효한 값이 지정되지 않은 경우 기본값은 www.amazon.com입니다. [ http://www.amazon.com,/www.amazon.com ] |
| 예시 | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
응답
RID를 통해 제품 리뷰 결과 받기
RID를 통해 최신 제품 리뷰 결과를 가져오기 위한 요청입니다.
신용공제
Get 호출에 대한 0(영) 크레딧 공제.
요청
| URI | /api/query/reviews/rid/{rid}?domain={도메인}&secretKey={secretKey} | { RID } – 최신 변형 목록을 가져오기 위한 요청 ID입니다. {domain} – 선택 사항 – 지정하지 않은 경우 기본값은 www.amazon.com입니다. 보다 지원되는 Amazon 도메인 목록을 위해. |
| 예시 | /api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
