API 목록으로 돌아가기
Amazon 공개 커머스 데이터

Amazon 공개 데이터 API

지원되는 마켓플레이스에서 공개 Amazon 상품을 검색하고, 정규화된 상품 상세 정보, Best Sellers, 리뷰, 판매자 프로필, 크리에이터 스토어 레코드를 수집합니다.

사용할 수 있는 Amazon API

공개 Amazon 워크플로에 맞춰 Product Search, Product Detail, Best Sellers, Reviews, Seller Info, Storefront를 사용합니다.

어떤 Amazon 데이터를 가져올 수 있나요?

SocQ는 지원되는 공개 Amazon 입력에서 정규화된 상품, 리뷰, 판매자, 크리에이터 스토어 레코드를 반환하며, 원본에서 사용할 수 있는 값을 제공하지 않으면 해당 필드를 null이 가능한 상태로 유지합니다.

상품 식별 정보와 콘텐츠

제공되는 상품 ID, 제목, 설명, 공개 URL, 플랫폼·리소스 라벨, 수집 타임스탬프를 가져옵니다.

판매자와 가격 정보

값이 제공되는 경우, 찾은 상품마다 정규화된 판매자 객체와 가격 값을 함께 보관합니다.

공개된 평판 신호

제공되는 평점, 리뷰 수, 판매 수를 특정 시점의 공개 관측값으로 활용할 수 있으며, 누락된 값을 0으로 취급하지 않습니다.

상품 미디어

상품 카탈로그, 검수 대기열, 후속 이미지 처리에 활용할 수 있는 정규화된 미디어 객체를 받습니다.

크리에이터 스토어

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

SocQ vs 페이지 직접 처리

SocQ는 지원되는 공개 Amazon 데이터에 대해 인증된 작업 워크플로와 표준 결과 스키마를 제공합니다. 페이지를 직접 처리하면 요청 오케스트레이션, 파싱, 저장, 페이지네이션, 스키마 유지보수를 애플리케이션이 맡아야 합니다.

기능SocQ페이지 직접 처리
시작 입력검색어 또는 지원되는 공개 Amazon URL페이지 URL과 애플리케이션 고유의 수집 로직
실행 방식상태를 폴링하는 비동기 작업애플리케이션에서 직접 정의하고 운영
상품 데이터 형태정규화된 상품 레코드페이지별 마크업과 직접 작성한 파싱
저장된 결과 접근커서 페이지네이션 항목애플리케이션이 관리하는 저장소와 페이지네이션

Amazon API 작동 방식

Amazon 엔드포인트는 비동기 작업을 실행한 뒤 커서 페이지네이션으로 결과를 가져오는 흐름을 따릅니다.

  1. 1. 엔드포인트 입력 제출

    선택한 엔드포인트에 필요한 검색어, 상품 URL, 카테고리 URL, 판매자 URL, 스토어 URL을 보내고 task_id를 저장합니다.

  2. 2. 처리 추적

    처리가 성공하거나 작업이 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 상품 가져오기

    data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라가 저장된 모든 레코드를 가져옵니다.

Best Sellers 페이지에서 상품 수집

SocQ API 키로 인증하고 공개 카테고리 목록 URL을 제출한 뒤, 비동기 작업을 따라가 상품 결과를 가져옵니다.

curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"],"results_limit":3}'

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

Amazon API 주요 활용 사례

카테고리 구색 조사

정해 둔 카테고리 조사 대상에 대해, 선택한 Best Sellers 페이지에 노출된 상품의 범위가 정해진 스냅샷을 만듭니다.

후보 상품 정보 보강

선택한 카테고리 페이지에서 찾은 상품에 제목, 설명, 판매자 정보, 가격, 미디어, 공개 링크를 추가합니다.

커머스 신호 비교

수집 시각을 유지한 채 정규화된 상품 간에 제공되는 가격, 평점, 리뷰 수, 판매 수를 비교합니다.

제휴 크리에이터 조사

탑 크리에이터 표시, 아이디어 리스트, 상품 수, 트렌딩 상품으로 여러 크리에이터 스토어를 비교해 제휴 파트너 후보를 추립니다.

제한 사항과 공개 데이터 정책

Amazon 결과는 지원되는 공개 페이지에서 특정 시점에 수집한 레코드입니다. 이 API는 고객 계정, 비공개 데이터, 장바구니, 주문, 재고 시스템, 판매자 관리 기능에는 접근하지 않습니다.

  • 지원되는 호스트는 amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp이며, 각 서브도메인도 포함됩니다.
  • 공개 Best Sellers 또는 카테고리 목록 페이지를 사용하세요. 호스트 검증만으로는 관련 없는 Amazon 페이지에 지원되는 상품 목록이 있다고 보장되지 않습니다.
  • results_limit의 기본값은 100이고 1부터 2,000까지 받으며, 작업에 포함된 모든 URL에서 저장되는 고유 결과의 총합을 제한합니다.
  • 안정적인 응답에는 Best Sellers 순위 필드가 포함되지 않습니다.
  • 사용할 수 있는 공개 값이 없으면 상품 ID, 콘텐츠, 판매자, 가격, 평점, 수치, 미디어, URL, 게시 시각은 null일 수 있습니다.

Amazon API 자주 묻는 질문

Amazon API란 무엇인가요?

Amazon API는 상품을 검색하고, 지원되는 공개 Amazon 입력에서 정규화된 상품, 리뷰, 판매자, 크리에이터 스토어 레코드를 수집합니다.

어떤 Amazon 엔드포인트를 사용할 수 있나요?

Product Search, Product Detail, Best Sellers, Reviews, Seller Info, Storefront를 공통 비동기 작업 흐름으로 사용할 수 있습니다.

카테고리 URL을 여러 개 수집할 수 있나요?

네. 한 작업에 URL을 여러 개 제출할 수 있습니다. 다만 results_limit은 URL별 제한이 아니라 작업 전체에서 공유하는 하나의 상한이라는 점에 유의하세요.

SocQ가 상품 순위도 반환하나요?

아니요. 순위는 안정적인 상품 스키마에 포함되지 않습니다. 제공되는 식별 정보, 판매자, 가격, 평판, 판매 수, 미디어, 출처, 타임스탬프 필드를 활용하세요.

Amazon 상품에서 필드가 누락될 수 있나요?

네. 표준 상품 필드는 null이 가능하며, 공개 레코드가 사용할 수 있는 값을 노출하지 않으면 누락된 상태로 유지됩니다.

Best Sellers 엔드포인트의 요금은 어떻게 되나요?

정상적으로 반환된 표준 상품 1건당 0.15 크레딧이 차감됩니다. 빈 결과에는 결과 요금이 없으며, 선결제된 크레딧 중 사용하지 않은 분은 작업이 정산될 때 환불됩니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.

Apple App Store API

이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.

SEO API

실시간 Google 오가닉 검색 결과를 조회하고, 키워드 수요와 순위 난이도를 비교하고, 시드 키워드를 확장하고, 사이트의 검색 노출을 이끄는 키워드와 페이지를 찾고, 검색 의도를 분류하며, Google 뉴스·이미지·자동완성과 Bing, YouTube 결과를 모읍니다. 모든 엔드포인트가 같은 SocQ API 키, 비동기 작업 흐름, 정규화된 결과 형식을 사용합니다.

Telegram API

t.me 링크로 공개 텔레그램 채널을 읽습니다. 구독자 수가 담긴 채널 정보, 조회수와 반응이 담긴 게시물, 개별 게시물, 토론 그룹 댓글, 추천 채널, 전체 기록 검색을 지원합니다.

Link in Bio API

크리에이터가 Instagram, TikTok, YouTube 소개란에 넣는 링크 하나를 표시 이름, 소개, 프로필 사진, 공개된 연락처 이메일, 연결된 SNS 프로필, 각 버튼의 제목과 연결 주소라는 구조화된 데이터로 바꿉니다.

Creator API

Instagram, TikTok, YouTube, X, Facebook, Threads 프로필 하나에서 출발해 크리에이터의 공개 비즈니스 이메일, 다른 SNS 계정, 프로필 사진 기반 나이·성별 추정을 가져옵니다.

Google Hotels API

목적지로 호텔을 검색하고, 원하는 호텔의 구글 호텔 프로필 전체와 1박 요금 캘린더를 가져옵니다. 세 API는 같은 호텔 ID로 연결됩니다.