amazon/
shop

amazon.com/shop URL로 아마존 크리에이터 스토어를 읽어 크리에이터 프로필, 연결된 SNS 계정, 상품 수가 포함된 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.

Amazon Storefront API

스토어 URL 입력
아이디어 리스트
큐레이션 게시물
트렌딩 상품
요청당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 하나를 보내고 한 행의 결과로 스토어를 읽습니다.

  1. /v1/amazon/shop에 {"url": "https://www.amazon.com/shop/sydneydelrey"}을 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 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로 미리 규모를 알 수 있습니다.

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 판매자 프로필 정보, 소개, 웹사이트, 평점, 피드백, 위치, 출처, 수집 시각 필드를 수집합니다.

다른 플랫폼 둘러보기

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

Amazon Storefront API — 자주 묻는 질문

Amazon Storefront API는 스토어 URL로 아마존 크리에이터 스토어를 읽는 프로그래밍 인터페이스입니다. 크리에이터 프로필, 연결된 SNS 계정, 아이디어 리스트, 큐레이션 게시물, 가격이 표시된 트렌딩 상품을 반환합니다.

요청마다 amazon.com/shop/이름 형식의 스토어 URL 하나를 보냅니다. amazon.co.uk/shop/이름처럼 다른 아마존 마켓플레이스의 스토어도 같은 방식으로 읽습니다.

스토어 첫 페이지에 보이는 아이디어 리스트, 큐레이션 게시물, 트렌딩 상품이 반환됩니다. 각 리스트와 큐레이션 게시물에는 링크와 상품 수가 있어 규모를 확인한 뒤 바로 열어 볼 수 있습니다.

각 트렌딩 상품에는 스토어 내 상품 링크, 상품 이미지, 마켓플레이스 통화 기준 현재 가격, 그리고 스토어에 표시된 경우 할인 라벨이 들어 있습니다.

요청 한 번에 스토어 하나를 읽고 0.5 크레딧이 듭니다. 스토어가 존재하지 않으면 작업이 실패하고 전액 환불됩니다.