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 사용 방법
대상 스토어프런트와 구체적인 상품 검색어를 정한 뒤, 비동기 요청을 한 번 제출합니다.
- 비어 있지 않은 query를 설정하고, 지원되는 Amazon 도메인 URL을 지정하며, 1~2,000 범위에서 results_limit을 정합니다.
- 요청을 /v1/amazon/product-search로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 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 trueAmazon Product Search API 추천 활용 사례
- 스토어프런트 상품 탐색: 지원되는 Amazon 스토어프런트 한 곳에서 카테고리, 기능, 브랜드, 구매 의도 문구에 맞는 공개 상품을 찾습니다.
- 판매 조건 비교: 반환된 상품의 가격 금액, 통화, 표시 가격, 판매자 정보를 비교합니다.
- 평판 선별: 확인 가능한 평점, 리뷰 수, 판매 수를 검토하며, 누락된 지표는 제공되지 않는 값으로 그대로 보존합니다.
- 카탈로그 정보 보강: 후보 상품에 정규화된 제목, 설명, 원본 URL, 미디어, 판매자, 수집 타임스탬프를 보강합니다.
Amazon Product Search API 활용 팁
- 같은 검색어라도 스토어프런트에 따라 결과가 달라질 수 있으므로, 작업마다 제출한 query와 domain을 함께 저장하세요.
- 필요한 결과 규모에 맞춰 results_limit을 정하세요. 이 값이 예약되는 결과 추정치를 결정하며, 최종 요금은 반환된 레코드 기준으로 정산됩니다.
- 성공한 작업에 저장된 결과 페이지가 둘 이상이면 has_more가 false가 될 때까지 next_cursor를 따라가세요.
- 누락된 판매자, 가격, 평점, 리뷰 수, 판매 수, 미디어 값은 0이나 빈 식별 정보가 아니라 제공되지 않는 값으로 취급하세요.
관련 API
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 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.