amazon/
product-search

지원되는 Amazon 스토어프런트에서 상품 검색어로 검색하여 정규화된 상품, 판매자, 가격, 평점, 리뷰, 판매 수, 미디어 필드를 받습니다.

Amazon Product Search API

상품 검색
스토어프런트 범위
정규화된 레코드
결과당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Amazon Product Search

Amazon Product Search는 상품 검색어와 스토어프런트 URL을 정규화된 공개 상품 레코드로 변환합니다. 각 항목에는 값이 제공되는 경우 원본 URL, 제목, 설명, 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어, 게시 시각, 수집 시각이 포함될 수 있습니다.

Amazon Product Search API 주요 기능

  • 스토어프런트 범위 쿼리비어 있지 않은 상품 쿼리를 지원되는 Amazon 도메인 하나와 함께 지정해 대상 스토어프런트를 명확히 합니다.
  • 결과 수 제어1~2,000 범위의 정수 results_limit을 설정하면, 수집기는 요청한 상한에 도달하거나 더 이상 원본 레코드가 없을 때 멈춥니다.
  • 정규화된 상품 식별 정보ID, 유형, 원본 URL, 제목, 설명, 게시 시각, 수집 시각에 대해 안정적인 상품 필드를 받습니다.
  • 커머스 정보스토어프런트마다 다른 결과 구조를 파싱할 필요 없이, 확인 가능한 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어 필드를 사용합니다.

Amazon Product Search API 매개변수

매개변수필수설명
query필수비어 있지 않아야 하는 상품 키워드 또는 문구로, 필수 값입니다.
domain필수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 또는 그 서브도메인이어야 합니다. 호스트 이름이 있는 모든 스킴과 프로토콜 상대 참조를 허용합니다.
results_limit선택1~2,000 범위의 결과 상한입니다. 생략하면 기본값 100이 적용됩니다.

Amazon Product Search API 사용 방법

대상 스토어프런트와 구체적인 상품 검색어를 정한 뒤, 비동기 요청을 한 번 제출합니다.

  1. 비어 있지 않은 query를 설정하고, 지원되는 Amazon 도메인 URL을 지정하며, 1~2,000 범위에서 results_limit을 정합니다.
  2. 요청을 /v1/amazon/product-search로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items를 읽고, has_more가 true인 동안 next_cursor를 전달합니다.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'

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

Amazon Product Search API 추천 활용 사례

  • 스토어프런트 상품 탐색: 지원되는 Amazon 스토어프런트 한 곳에서 카테고리, 기능, 브랜드, 구매 의도 문구에 맞는 공개 상품을 찾습니다.
  • 판매 조건 비교: 반환된 상품의 가격 금액, 통화, 표시 가격, 판매자 정보를 비교합니다.
  • 평판 선별: 확인 가능한 평점, 리뷰 수, 판매 수를 검토하며, 누락된 지표는 제공되지 않는 값으로 그대로 보존합니다.
  • 카탈로그 정보 보강: 후보 상품에 정규화된 제목, 설명, 원본 URL, 미디어, 판매자, 수집 타임스탬프를 보강합니다.

Amazon Product Search API 활용 팁

  • 같은 검색어라도 스토어프런트에 따라 결과가 달라질 수 있으므로, 작업마다 제출한 query와 domain을 함께 저장하세요.
  • 필요한 결과 규모에 맞춰 results_limit을 정하세요. 이 값이 예약되는 결과 추정치를 결정하며, 최종 요금은 반환된 레코드 기준으로 정산됩니다.
  • 성공한 작업에 저장된 결과 페이지가 둘 이상이면 has_more가 false가 될 때까지 next_cursor를 따라가세요.
  • 누락된 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어 값은 0이나 빈 식별 정보가 아니라 제공되지 않는 값으로 취급하세요.

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

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

다른 플랫폼 둘러보기

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

Amazon Product Search API — 자주 묻는 질문

Amazon Product Search API는 상품 쿼리로 지원되는 Amazon 스토어프런트 한 곳을 검색하고, 비동기 작업 방식으로 정규화된 공개 상품 레코드를 반환합니다.

런타임은 파싱된 호스트 이름을 확인하며 amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp와 그 서브도메인을 허용합니다. 호스트 이름이 있는 모든 스킴과 프로토콜 상대 참조를 허용합니다.

query와 domain은 비어 있지 않아야 하는 필수 문자열입니다. results_limit은 선택 항목이며 기본값은 100이고, 1~2,000 범위의 정수여야 합니다.

상품에는 ID, 플랫폼, 리소스, 유형, 원본 URL, 게시·수집 시각, 제목, 설명, 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어가 포함될 수 있습니다. null이 될 수 있는 필드는 원본이 사용할 수 있는 값을 제공할 때만 값이 들어갑니다.

results_limit은 최대값입니다. 공개 원본에 일치하는 레코드가 더 없으면 수집이 일찍 끝날 수 있으므로, 성공한 작업도 상품이 더 적거나 없을 수 있습니다.

/v1/tasks/{task_id}를 폴링하고, 성공 후 data.results.items를 읽으며, has_more가 true인 동안 next_cursor로 다음 작업 결과 페이지를 요청합니다.

정상적으로 반환된 정규화 상품 1건당 0.15 SocQ 크레딧이 차감됩니다. 요청은 results_limit(생략 시 100)을 기준으로 크레딧을 확보한 뒤 실제 결과 수에 맞춰 정산하고 사용하지 않은 크레딧을 환불하며, 빈 결과에는 결과 요금이 없습니다.