amazon/
reviews

지원되는 URL에서 공개 Amazon 상품 리뷰를 수집하여 본문, 평점, 작성자 정보, 상품 참조, 타임스탬프, 미디어를 정규화된 레코드로 반환합니다.

Amazon Reviews API

여러 상품 URL
리뷰 텍스트와 평점
작성자·상품 정보
정규화된 리뷰 레코드
결과당 0.15 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Amazon Reviews

Amazon 상품 리뷰는 작성된 본문, 평점, 작성자 정보, 게시 시각, 상품 참조, 첨부 미디어로 이루어진 공개 고객 피드백 레코드입니다. 이러한 레코드는 상품 피드백 조사, 평점 비교, 리뷰 모니터링, 출처 링크가 포함된 데이터 보강에 활용할 수 있습니다.

Amazon Reviews API 주요 기능

  • 여러 상품 URL 입력지원되는 Amazon 상품 URL을 하나의 작업에 하나 이상 제출할 수 있으며, 저장되는 정규화된 리뷰 전체에 하나의 결과 상한이 적용됩니다.
  • 리뷰 내용과 작성자각 레코드에는 공개 리뷰 본문, 숫자 평점, 작성자 정보, 게시 시각, 첨부된 이미지·동영상을 보존할 수 있습니다.
  • 상품과 연결된 레코드정규화된 결과는 리뷰 식별 정보 및 원본 링크와 함께 상품 식별자와 상품 URL을 유지하므로, 레코드가 리뷰 대상 상품과 계속 연결됩니다.

Amazon Reviews API 매개변수

매개변수필수설명
urls필수비어 있지 않은 Amazon 상품 참조(URL)의 필수 목록입니다. 파싱된 각 호스트 이름은 지원되는 마켓플레이스 또는 서브도메인에 속해야 하며, 호스트 이름이 있는 모든 스킴과 프로토콜 상대 참조를 허용합니다. 각 항목은 공급자 입력 행 하나가 됩니다.
results_limit선택작업 전체에 저장되는 정규화된 리뷰의 최대 개수로, 기본값은 100이며 1~2,000 범위의 정수를 받습니다.

Amazon Reviews API 사용 방법

지원되는 상품 URL을 제출하고, 비동기 작업을 추적한 뒤, 정규화된 리뷰 레코드를 커서 페이지네이션으로 읽습니다.

  1. 지원되는 Amazon 상품 URL을 하나 이상 준비하고, 1~2,000 범위에서 results_limit을 정합니다.
  2. 요청을 /v1/amazon/reviews로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Amazon Reviews API 추천 활용 사례

  • 상품 피드백 조사: 리뷰 본문, 평점, 작성자, 게시 시각으로 알고 있는 상품에 대해 반환된 공개 피드백을 살펴봅니다.
  • 상품 간 평점 비교: 여러 상품 URL을 제출하고, 반환된 평점을 subject_id 또는 subject_url 기준으로 묶어 수집한 리뷰 레코드를 비교합니다.
  • 리뷰 근거 데이터 보강: 원본 링크, 상품 참조, 작성자 정보, 타임스탬프, 리뷰 미디어를 기존 상품 데이터셋이나 모니터링 레코드에 붙입니다.

Amazon Reviews API 활용 팁

  • 파싱된 호스트 이름이 지원되는 Amazon 마켓플레이스에 속하는 상품 URL을 사용하세요. 관련 없는 호스트의 단축 링크와 지원되지 않는 지역 호스트는 검증에 실패합니다.
  • 제출한 모든 URL을 통틀어 저장하려는 리뷰의 총 개수로 results_limit을 설정하고, 저장된 모든 페이지를 읽으려면 has_more가 false가 될 때까지 next_cursor를 따라가세요.
  • 리뷰 id가 있으면 이를 기준으로 레코드를 관리하고, 상품별로 리뷰를 묶을 때는 subject_id 또는 subject_url을 함께 보관하세요.
  • 누락된 본문, 작성자 필드, 평점, 타임스탬프, 상품 참조, 미디어는 임의의 대체 값을 만들지 말고 알 수 없는 값으로 취급하세요.

Amazon Reviews API 외에 Amazon의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Amazon Best Sellers API — 공개 Amazon 베스트셀러 카테고리 URL에서 상품을 수집하며, 정규화된 판매자, 가격, 평판, 판매량, 미디어, 출처, 타임스탬프 필드를 포함합니다.
  • Amazon Product Details API — 알고 있는 Amazon URL에서 상품 상세를 수집하며, 제목, 설명, 판매자, 가격, 평점, 리뷰 수, 판매량, 미디어 필드를 포함합니다.
  • Amazon Product Search API — 지원되는 Amazon 스토어에서 상품 검색어로 검색하고, 가져올 수 있는 경우 정규화된 상품, 판매자, 가격, 평점, 리뷰, 판매량, 미디어, 출처 필드를 반환합니다.
  • Amazon Seller Info API — 알고 있는 판매자 URL에서 공개 Amazon 판매자 프로필 정보, 소개, 웹사이트, 평점, 피드백, 위치, 출처, 수집 시각 필드를 수집합니다.
  • Amazon Storefront API — 스토어 URL로 아마존 크리에이터 스토어를 읽어 프로필, 연결된 SNS 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.

다른 플랫폼 둘러보기

Amazon 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Amazon Reviews API — 자주 묻는 질문

Amazon Reviews API는 지원되는 Amazon 상품 URL에서 공개 상품 리뷰를 수집하는 프로그래밍 인터페이스입니다. 정규화된 리뷰 본문, 평점, 작성자 정보, 타임스탬프, 상품 참조, 원본 링크, 미디어를 반환합니다.

파싱된 호스트 이름이 amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp 또는 그 서브도메인인, 비어 있지 않은 urls 배열을 제출합니다. 호스트 이름이 있는 모든 스킴과 프로토콜 상대 참조를 허용합니다.

results_limit은 URL마다 보장되는 개수가 아니라 작업 전체에 저장되는 정규화된 리뷰의 최대 개수입니다. 반환된 공개 리뷰가 적거나 중복 레코드가 제거되면 작업이 더 적은 레코드로 끝날 수 있습니다.

작업이 성공하면 data.results.items를 읽고, has_more가 true인 동안 next_cursor를 작업 엔드포인트에 전달합니다. 작업 결과 엔드포인트는 1~500 범위의 페이지 한도를 받습니다.

정상적으로 저장된 리뷰 1건당 0.15 SocQ 크레딧이 차감됩니다. 요청 시 results_limit을 기준으로 크레딧을 확보한 뒤 실제 결과 수에 맞춰 정산하며, 빈 결과에는 결과 요금이 없습니다.