amazon/
product-detail

알고 있는 URL에서 공개 Amazon 상품 상세 정보를 수집하여 제목, 설명, 판매자, 가격, 평점, 리뷰·판매 수, 미디어를 정규화된 레코드로 반환합니다.

Amazon Product Details API

알고 있는 상품 URL
다중 마켓플레이스 입력
정규화된 상품 레코드
결과당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 저장한 뒤, 작업이 성공하면 정규화된 상품 레코드를 읽습니다.

  1. Bearer 토큰 또는 API 키를 사용해 urls 배열을 /v1/amazon/product-detail로 POST합니다.
  2. 반환된 task_id를 저장하고, status가 succeeded 또는 failed가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 성공하면 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 true

Amazon Product Details API 추천 활용 사례

  • 알고 있는 상품의 카탈로그 보강: 이미 가지고 있는 Amazon URL 목록에 상품 제목, 설명, 판매자 정보, 가격, 미디어, 평점, 수치를 붙입니다.
  • 특정 시점 상품 비교: 같은 시점에 수집한 상품 레코드 중 선택한 항목의 정규화된 가격, 통화, 평점, 리뷰 수, 판매 수, 판매자 필드를 비교합니다.
  • 상품 출처 검증: 식별자, 정식 URL, 제목, 설명, 미디어 참조, 수집 타임스탬프로 저장해 둔 카탈로그 참조를 공개 상품 페이지와 대조해 검토합니다.

Amazon Product Details API 활용 팁

  • 파싱된 호스트 이름이 지원되는 Amazon 마켓플레이스에 속하는 상품 URL을 사용하세요. 호스트가 유효해도 대상이 공개 상품 레코드로 확인된다는 보장은 없습니다.
  • 이 엔드포인트는 공급자 결과 상한을 제출한 URL 수로 고정하므로 results_limit을 보내지 마세요.
  • 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어, URL, 게시 시각 필드는 null일 수 있는 값으로 취급하고, 항목이 0개로 성공한 작업도 임의의 대체 데이터를 만들지 말고 그대로 보존하세요.
  • next_cursor는 저장된 작업 결과를 페이지 단위로 읽을 때만 사용하고, 유료 POST를 반복하지 말고 같은 작업에 대한 GET 요청을 이어 가세요.

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 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.

다른 플랫폼 둘러보기

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

Amazon Product Details API — 자주 묻는 질문

Amazon Product Details API는 알고 있는 Amazon URL에서 공개 상품 상세 정보를 수집하는 프로그래밍 인터페이스입니다. 정규화된 식별자, 제목, 설명, 판매자·가격 객체, 평점, 리뷰·판매 수, 미디어, 수집 메타데이터를 반환합니다.

Amazon 상품 URL이 담긴 비어 있지 않은 urls 배열을 제출합니다. 미국, 영국, 독일, 프랑스, 스페인, 이탈리아, 캐나다, 호주, 인도, 일본의 Amazon 호스트와 그 서브도메인을 허용합니다.

네. urls 배열에 알고 있는 URL을 여러 개 넣으면 됩니다. 공급자 결과 상한은 제출한 URL 수와 같으며, 유효하지 않거나 사용할 수 없거나 오류가 난 행이 있으면 성공한 결과 수가 더 적을 수 있습니다.

안정적인 상품 스키마에는 식별·출처 필드, 제목, 설명, 중첩된 판매자·가격 객체, 평점, 리뷰 수, 보고된 판매 수, 미디어, 타임스탬프가 포함됩니다. 원본에서 제공되지 않는 선택 값은 null로 유지됩니다.

페이지네이션은 상품 URL을 제출할 때가 아니라 작업 성공 후 저장된 결과를 읽을 때 적용됩니다. has_more가 true인 동안에만 GET /v1/tasks/{task_id}에 next_cursor를 넣어 이어서 요청하세요.

요청 시 제출한 URL 1개당 0.15 크레딧을 예상치로 확보하고, 정상적으로 반환된 상품 레코드 1건당 0.15 크레딧으로 정산합니다. 기본 요금이 0 크레딧이고 빈 결과에는 기본 요금만 적용하는 정책이므로, 반환된 레코드가 없는 작업은 0으로 정산됩니다.