Amazon Product Details
Amazon 상품은 식별자, 제목, 설명, 판매자 정보, 가격, 평점, 리뷰 수, 판매 수, 미디어로 설명되는 공개 카탈로그 항목입니다. 이러한 필드는 카탈로그 정보 보강, 상품 비교, 출처 검증, 특정 시점의 상품 리포트에 활용할 수 있습니다.
Amazon Product Details API 주요 기능
- 알고 있는 상품 URL 일괄 조회하나의 작업에 Amazon URL을 하나 이상 제출하면, 제출한 유효한 URL 수를 넘지 않는 범위에서 정규화된 상품 레코드를 받습니다.
- 상품 식별 정보, 설명, 미디어각 레코드에는 상품 식별자와 URL, 제목, 설명, 수집 타임스탬프, 확인 가능한 이미지·동영상 참조가 포함될 수 있습니다.
- 판매자, 가격, 공개된 상품 지표중첩된 판매자·가격 객체가 평점, 리뷰 수, 보고된 판매 수 필드와 함께 제공되어 필드 단위로 일관되게 처리할 수 있습니다.
- 지원되는 Amazon 마켓플레이스 호스트URL 검증기는 미국, 영국, 독일, 프랑스, 스페인, 이탈리아, 캐나다, 호주, 인도, 일본의 Amazon 호스트와 그 서브도메인을 허용합니다.
Amazon Product Details API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 알고 있는 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 또는 그 서브도메인이어야 합니다. 호스트 이름이 있는 모든 스킴과 프로토콜 상대 참조를 허용합니다. |
Amazon Product Details API 사용 방법
알고 있는 상품 URL을 제출하고 비동기 작업 ID를 저장한 뒤, 작업이 성공하면 정규화된 상품 레코드를 읽습니다.
- Bearer 토큰 또는 API 키를 사용해 urls 배열을 /v1/amazon/product-detail로 POST합니다.
- 반환된 task_id를 저장하고, status가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 읽고, has_more가 true이면 상품 작업을 다시 제출하지 말고 next_cursor로 다음 결과 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueAmazon Product Details API 추천 활용 사례
- 알고 있는 상품의 카탈로그 보강: 이미 가지고 있는 Amazon URL 목록에 상품 제목, 설명, 판매자 정보, 가격, 미디어, 평점, 수치를 붙입니다.
- 특정 시점 상품 비교: 같은 시점에 수집한 상품 레코드 중 선택한 항목의 정규화된 가격, 통화, 평점, 리뷰 수, 판매 수, 판매자 필드를 비교합니다.
- 상품 출처 검증: 식별자, 정식 URL, 제목, 설명, 미디어 참조, 수집 타임스탬프로 저장해 둔 카탈로그 참조를 공개 상품 페이지와 대조해 검토합니다.
Amazon Product Details API 활용 팁
- 파싱된 호스트 이름이 지원되는 Amazon 마켓플레이스에 속하는 상품 URL을 사용하세요. 호스트가 유효해도 대상이 공개 상품 레코드로 확인된다는 보장은 없습니다.
- 이 엔드포인트는 공급자 결과 상한을 제출한 URL 수로 고정하므로 results_limit을 보내지 마세요.
- 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어, URL, 게시 시각 필드는 null일 수 있는 값으로 취급하고, 항목이 0개로 성공한 작업도 임의의 대체 데이터를 만들지 말고 그대로 보존하세요.
- next_cursor는 저장된 작업 결과를 페이지 단위로 읽을 때만 사용하고, 유료 POST를 반복하지 말고 같은 작업에 대한 GET 요청을 이어 가세요.
관련 API
Amazon Product Details API 외에 Amazon의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Amazon Best Sellers API — 공개 Amazon 베스트셀러 카테고리 URL에서 상품을 수집하며, 정규화된 판매자, 가격, 평판, 판매량, 미디어, 출처, 타임스탬프 필드를 포함합니다.
- Amazon Product Search API — 지원되는 Amazon 스토어에서 상품 검색어로 검색하고, 가져올 수 있는 경우 정규화된 상품, 판매자, 가격, 평점, 리뷰, 판매량, 미디어, 출처 필드를 반환합니다.
- Amazon Reviews API — 지원되는 Amazon URL에서 공개 상품 리뷰를 수집하며, 본문, 평점, 작성자 정보, 상품 참조, 타임스탬프, 미디어를 포함합니다.
- Amazon Seller Info API — 알고 있는 판매자 URL에서 공개 Amazon 판매자 프로필 정보, 소개, 웹사이트, 평점, 피드백, 위치, 출처, 수집 시각 필드를 수집합니다.
- Amazon Storefront API — 스토어 URL로 아마존 크리에이터 스토어를 읽어 프로필, 연결된 SNS 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.