Amazon Storefront
Amazon storefront는 아마존 인플루언서 프로그램에 참여한 크리에이터가 자신의 숍 이름으로 운영하는 페이지로, 상품을 아이디어 리스트와 큐레이션 게시물로 묶고 소개글, 프로필 사진, SNS 링크, 트렌딩 상품 목록을 함께 보여 줍니다. 이 페이지를 읽으면 크리에이터가 누구인지, 어디에서 또 활동하는지, 추천을 어떻게 정리하는지, 지금 어떤 상품을 얼마에 밀고 있는지 알 수 있습니다.
Amazon Storefront API 주요 기능
- 프로필과 탑 크리에이터 표시name, text, avatar_url로 표시 이름, 스토어 소개글, 프로필 사진을 확인하고 is_top_creator로 아마존이 탑 크리에이터로 표시했는지 알 수 있습니다.
- 연결된 SNS 계정social_urls에는 스토어 상단에 연결된 TikTok, YouTube, Pinterest 등의 프로필 링크가 담깁니다.
- 상품 수가 포함된 아이디어 리스트lists는 스토어 첫 페이지의 아이디어 리스트를 제목, 링크, 커버 이미지, 담긴 상품 수인 items_count와 함께 반환합니다.
- 큐레이션 게시물curations는 크리에이터의 큐레이션 게시물을 제목, 링크, 커버 이미지, 묶인 상품 수인 posts_count와 함께 반환합니다.
- 가격이 표시된 트렌딩 상품trending_picks는 스토어가 현재 강조하는 상품을 반환하며, 각 상품에 스토어 내 링크, 이미지, 해당 마켓플레이스 통화 기준 현재 가격, 표시된 할인 정보가 붙습니다.
Amazon Storefront API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 아마존 크리에이터의 스토어 URL. https://www.amazon.com/shop/<name> 형식이며 다른 아마존 마켓플레이스의 스토어 URL도 같은 방식으로 사용할 수 있습니다. |
Amazon Storefront API 사용 방법
스토어 URL 하나를 보내고 한 행의 결과로 스토어를 읽습니다.
- /v1/amazon/shop에 {"url": "https://www.amazon.com/shop/sydneydelrey"}을 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- results.items에서 스토어를 읽습니다. has_more와 results.next_cursor는 일반 페이지네이션 규칙을 따르며 이 단일 행 결과에서는 비어 있습니다.
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.amazon.com/shop/sydneydelrey"}'Amazon Storefront API 추천 활용 사례
- 제휴 크리에이터 발굴: 여러 스토어의 is_top_creator, 아이디어 리스트 수, items_count를 비교해 우리 카테고리 상품을 꾸준히 정리하는 크리에이터를 추려 냅니다.
- 크리에이터 추천 상품 변화 추적: 같은 스토어를 매주 다시 읽어 리스트 제목, items_count, trending_picks를 비교하고 어떤 시즌 리스트가 커지는지, 어떤 상품이 앞으로 나오는지 확인합니다.
- 스토어와 SNS 계정 연결: social_urls로 스토어를 크리에이터의 TikTok, YouTube, Pinterest 프로필과 묶어 커머스 활동과 SNS 영향력을 한 레코드에서 관리합니다.
Amazon Storefront API 활용 팁
- trending_picks.price는 해당 마켓플레이스 통화 기준이므로 결과와 함께 도메인도 저장하세요.
- URL에서 가져온 스토어 이름인 id를 키로 쓰면 같은 크리에이터를 여러 번 읽어도 데이터가 맞춰집니다.
- 개별 상품이 필요하면 리스트나 큐레이션 게시물의 url을 열면 되고, items_count와 posts_count로 미리 규모를 알 수 있습니다.
관련 API
Amazon Storefront API 외에 Amazon의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Amazon Best Sellers API — 공개 Amazon 베스트셀러 카테고리 URL에서 상품을 수집하며, 정규화된 판매자, 가격, 평판, 판매량, 미디어, 출처, 타임스탬프 필드를 포함합니다.
- Amazon Product Details API — 알고 있는 Amazon URL에서 상품 상세를 수집하며, 제목, 설명, 판매자, 가격, 평점, 리뷰 수, 판매량, 미디어 필드를 포함합니다.
- Amazon Product Search API — 지원되는 Amazon 스토어에서 상품 검색어로 검색하고, 가져올 수 있는 경우 정규화된 상품, 판매자, 가격, 평점, 리뷰, 판매량, 미디어, 출처 필드를 반환합니다.
- Amazon Reviews API — 지원되는 Amazon URL에서 공개 상품 리뷰를 수집하며, 본문, 평점, 작성자 정보, 상품 참조, 타임스탬프, 미디어를 포함합니다.
- Amazon Seller Info API — 알고 있는 판매자 URL에서 공개 Amazon 판매자 프로필 정보, 소개, 웹사이트, 평점, 피드백, 위치, 출처, 수집 시각 필드를 수집합니다.