100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
Amazon logoAmazon API

Amazon 상품·리뷰 데이터 API

SocialCrawl API 키로 Amazon 검색, 상품 상세, 리뷰, 판매자, 샵 페이지를 구조화 JSON으로 가져옵니다. 공유 커머스 스키마입니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
Amazon logo
/v1/amazon

활성 엔드포인트는 8개입니다. 1·5 크레딧 티어입니다.

  • GET /v1/amazon/shop
  • GET /v1/amazon/product-search
  • GET /v1/amazon/product
  • GET /v1/amazon/reviews
  • GET /v1/amazon/sellers
  • GET /v1/amazon/best-sellers
  • GET /v1/amazon/deals
  • GET /v1/amazon/seller

Amazon 엔드포인트

Amazon 커머스 읽기 엔드포인트는 8개입니다. 샵 페이지, 키워드 검색, ASIN 상품 상세, 리뷰, 판매자 오퍼, 베스트셀러, 딜, 판매자 프로필을 제공합니다. 데이터 API만 지원하며 구매, 장바구니, 판매자 계정 도구는 포함되지 않습니다.

샵 페이지

1 크레딧
/v1/amazon/shop

Amazon 샵 또는 스토어프론트 URL의 상품 카드입니다. 이름, 가격, 평점, 이미지가 포함됩니다.

url

상품 검색

1 크레딧
/v1/amazon/product-search

Amazon 마켓플레이스를 키워드로 검색합니다. 심화 조회용 ASIN이 있는 상품 목록입니다. country와 depth를 선택합니다.

query, country, depth

ASIN 상품 상세

5 크레딧
/v1/amazon/product

ASIN 1건의 상품 상세입니다. 제목, 가격, 평점, 이미지, 속성이 포함됩니다. 고급 티어(5 크레딧)입니다.

asin, country

상품 리뷰

5 크레딧
/v1/amazon/reviews

ASIN 상품 리뷰입니다. 평점, 본문, 작성자, 날짜가 포함됩니다. 고급 티어(5 크레딧)입니다.

asin, country

판매자·오퍼

1 크레딧
/v1/amazon/sellers

ASIN 상품의 판매자와 오퍼 목록입니다. 바이박스 주변 가격 경쟁을 봅니다.

asin, country

베스트셀러

1 크레딧
/v1/amazon/best-sellers

카테고리 슬러그 기준 베스트셀러 순위입니다. type으로 New Releases나 Movers and Shakers로 바꿉니다.

category, country, type, page

현재 딜

1 크레딧
/v1/amazon/deals

딜 페이지의 현재 Amazon 딜입니다. 딜 가격, 정가, 할인액, ASIN이 포함됩니다.

country

판매자 프로필

1 크레딧
/v1/amazon/seller

판매자 id 하나의 Amazon 판매자 프로필입니다. 이름, 스토어 URL, 평점, 평점 수가 포함됩니다.

seller_id, country

Amazon API8개 엔드포인트 지원
문서 보기

Amazon shop 또는 스토어프론트 페이지에 진열된 상품을 상품명, 가격, 평점, 이미지와 함께 반환합니다.

카탈로그 전체를 검색하는 대신 그 판매자가 자기 페이지에 올려둔 상품만 보고 싶을 때 사용하세요.

1크레딧

GET/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fsydneydelrey

url · Full URL of the Amazon shop or storefront page

$ curl https://www.socialcrawl.dev/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fsydneydelrey \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다

Amazon API 동작

Amazon도 다른 SocialCrawl 커머스 엔드포인트와 같습니다. API 키로 GET /v1/amazon/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Amazon OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.

GET과 쿼리 파라미터

Amazon 라우트는 모두 GET입니다. asin, query, url, country, depth를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

shop, search, sellers는 1 크레딧입니다. product와 reviews는 5 크레딧입니다. 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.

연동 순서

대부분 제품은 먼저 검색한 뒤 필요한 ASIN만 상세, 리뷰, 판매자로 깊게 봅니다.

01검색
GET /v1/amazon/product-search?query=…

ASIN, 제목, 가격이 있는 ProductList

상세에 고급 크레딧을 쓰기 전에 후보를 고릅니다.

02상품
GET /v1/amazon/product?asin=…

ASIN 1건의 전체 Product

검색 카드는 전체 상품 상세가 아닙니다.

03리뷰
GET /v1/amazon/reviews?asin=…

해당 ASIN의 ReviewList

VoC 텍스트는 product가 아니라 reviews에 있습니다.

04판매자
GET /v1/amazon/sellers?asin=…

ASIN 오퍼 SellerList

가격·판매자 경쟁은 별도 읽기입니다.

요청
GET /v1/amazon/product-search
  ?query=wireless+earbuds
  &country=US
  &depth=20
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/amazon/product?asin=B0FQFB8FMG&country=US
GET /v1/amazon/reviews?asin=B0FQFB8FMG&country=US
응답 봉투
{
  "success": true,
  "data": {
    "product": {
      "id": "B0FQFB8FMG",
      "title": "Example wireless earbuds",
      "price": { "current": 29.99, "currency": "USD" },
      "rating": 4.5,
      "url": "https://www.amazon.com/dp/B0FQFB8FMG"
    }
  },
  "credits_used": 5,
  "credits_remaining": 9995,
  "request_id": "req_…",
  "cached": false
}

data 형태

필드 이름은 다른 SocialCrawl 커머스 플랫폼과 같습니다. 한 번 파싱하면 Amazon, Walmart, Target에 재사용합니다.

Productproduct

id (ASIN), title, price, rating, images, attributes, url, country

ProductList / Postproduct-search, shop

title, price, rating, ASIN 또는 product url이 있는 items·샵 카드

ReviewListreviews

items[]에 author, content.text, rating, published_at

SellerListsellers

오퍼 행: seller, price, condition, fulfillment

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Amazon은 사이드카가 아닙니다.

  1. 01

    엣지가 호출을 받음

    Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 amazon/product-search (or product, reviews, sellers)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 product, reviews, search, sellers는 실시간 머천트 조회로, shop은 스토어프론트 URL 조회로 처리합니다. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.

  4. 04

    정규화 후 반환

    업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • shop / product-search / sellers 라이브 미스: 1 크레딧
  • ASIN 상품: 5 크레딧
  • ASIN 리뷰: 5 크레딧
  • 캐시 히트: 0 크레딧
  • 빈 응답 / 하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 과금 없음
  • 크레딧 부족: 402, 과금 없음
  • country로 마켓플레이스 선택
  • 장바구니·구매·판매자 쓰기 라우트 없음

데이터 수집 방식

Amazon은 공개 마켓플레이스 데이터입니다. SocialCrawl 커머스 스키마로 정규화하므로 별도 머천트 SDK를 배울 필요가 없습니다.

이 API에서 Amazon의 의미

공개 상품 검색, 상세, 리뷰, 판매자 오퍼, 인플루언서 샵 페이지입니다. 읽기 전용이며 구매와 Seller Central 접근은 없습니다.

SocialCrawl 수집 경로

product, reviews, search, sellers는 Amazon 공개 마켓플레이스를 실시간으로 읽습니다. shop 페이지는 전달한 스토어프론트 URL을 읽습니다. 모두 같은 SocialCrawl 키로 호출합니다.

엣지에서 나가는 형태

커머스 플랫폼이 공유하는 Product, ProductList, ReviewList, SellerList 아키타입의 통합 JSON 봉투입니다.

라이브로 제공하지 않는 것

장바구니, 결제, 재고, 광고 쓰기 API는 없습니다. 비공개 Seller Central 지표도 없습니다.

필드 매핑
ASIN / marketplace row→ product.*title, price, rating, images
review payload→ ReviewList items[]stars, body, author, date
offer matrix→ SellerListASIN에서 경쟁하는 판매자

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

8active Amazon endpoints in the registry
1 / 5shop·search와 product·reviews 크레딧 구간

ASIN 조사, 리뷰 수집, 오퍼 모니터링

호출은 키워드 검색으로 ASIN을 확정한 뒤 product, reviews, sellers로 분기합니다. ASIN 상품·리뷰는 5 크레딧 고정, sellers·search는 1 크레딧이며 SocialCrawl 전 구간 동일 키입니다.

검색과 상세는 라이브 미스 기준 보통 수 초입니다. 콜드 마켓 쿼리에서는 더 걸릴 수 있습니다.

Amazon API 활용 사례

Amazon 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

카테고리 매니저

Python, notebooks, BI

키워드로 product-search 후 후보 ASIN에 product와 sellers를 호출합니다.

VoC 팀

Node, warehouses

ASIN별 reviews로 브랜드·경쟁 언어를 모읍니다. 고급 티어이며 반복 호출은 캐시에 유리합니다.

가격 운영

Go, workers

고정 ASIN 집합에 sellers와 product로 오퍼·정가 변화를 확인합니다.

두 줄로 호출

search와 sellers는 1 크레딧입니다. product와 reviews는 5 크레딧입니다. 캐시 히트는 무료입니다.

curl "https://www.socialcrawl.dev/v1/amazon/product-search?query=wireless+earbuds&country=US&depth=20" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/amazon/product?asin=B0FQFB8FMG&country=US" \
  -H "x-api-key: sc_your_api_key_here"
Amazon logoSocialCrawl의 Amazon

카탈로그 전 구간과 같은 키

플랫폼 문서API 키 받기
엔드포인트

Amazon API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ShopGet Amazon shop pageProduct SearchSearch Amazon products by keywordProductGet an Amazon product by ASINReviewsGet Amazon product reviewsSellersGet Amazon sellers and offers for a productBest SellersGet Amazon Best Sellers in a categoryDealsGet current Amazon dealsSellerGet an Amazon seller profile
비교

SocialCrawl과 아마존 PA-API, 뭐가 다른가요?

같은 Amazon 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

인증

SocialCrawl
가입 즉시 x-api-key 헤더 하나로 호출할 수 있어요
아마존 PA-API
제휴 판매 실적이 있는 어소시에이트 계정이 있어야 해요

시작 준비

SocialCrawl
SDK나 요청 서명 없이 GET 한 번이면 돼요
아마존 PA-API
AWS 방식 자격 증명으로 서명한 요청과 전용 SDK가 필요해요

호출 한도

SocialCrawl
판매 실적과 상관없이 단순 크레딧 요금제예요
아마존 PA-API
제휴 매출에 따라 호출 한도가 정해져요

응답 스키마

SocialCrawl
구글 쇼핑·트러스트파일럿과 공유하는 통합 커머스 스키마예요
아마존 PA-API
제휴 용도에 맞춘 PA-API 전용 리소스 모델이에요

데이터 범위

SocialCrawl
숍 페이지, 상품 검색·상세, 리뷰 원문, 판매자 프로필까지 받아요
아마존 PA-API
상품 카탈로그는 충실하지만 리뷰 원문과 인플루언서 숍은 없어요

요금

SocialCrawl
스탠다드 1 크레딧, 어드밴스드 5 크레딧, 가입 시 100 크레딧 무료예요
아마존 PA-API
무료지만 제휴 판매가 끊기면 접근 권한도 사라져요
자주 묻는 질문

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기
아마존 인플루언서 숍은 어떻게 수집하나요?
SocialCrawl에서 제공하는 Amazon 엔드포인트 하나로 모든 작업이 끝나요. 숍 URL을 url 파라미터에 담아 GET /v1/amazon/shop을 호출하면 숍 정보, 상품, 가격, ASIN, 이미지가 통합 JSON으로 정리돼서 와요.
Amazon API는 어떤 데이터를 응답해 주나요?
숍 이름과 설명, 인플루언서 이름과 프로필 이미지, 그리고 각 상품의 제목, 가격, ASIN, 이미지 URL, Amazon 상품 URL이 배열로 정리돼서 받아볼 수 있어요. 모든 필드가 51개 플랫폼 공통 스키마로 정리돼 있어요.
Amazon Shop API는 요금이 얼마인가요?
한 번 요청에 1 크레딧이 소진돼요(스탠다드 티어). 새 계정에는 100 크레딧이 무료로 제공돼서 신용카드 없이 약 100개 숍을 먼저 받아볼 수 있어요.
아마존 숍 데이터를 수집하는 게 법적으로 괜찮나요?
SocialCrawl은 아마존 숍 페이지의 공개 정보만 가져와요. URL을 아는 누구나 볼 수 있는 내용이지만, 사용 목적이 Amazon 약관과 개인정보 관련 법령에 부합하는지는 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.
프로덕션 환경에서도 Amazon API를 써도 되나요?
네, 안정적인 응답 속도와 업스트림 자동 재시도, 그리고 Amazon 페이지가 바뀌어도 깨지지 않는 통합 스키마를 제공해요. 안심하고 프로덕션에 붙이실 수 있어요.
가장 좋은 아마존 스크래퍼 API는 무엇인가요?
SocialCrawl을 추천해요. 인플루언서 숍, 상품 검색, 상품 상세, 리뷰, 판매자까지 엔드포인트 8종을 통합 스키마로 받아요. 어소시에이트 계정이나 프록시 관리 없이 스탠다드 1 크레딧, 어드밴스드 5 크레딧으로 호출하고, 가입하면 신용카드 없이 100 크레딧을 무료로 드려요.
Amazon 스크래핑 API와 공식 Amazon API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Amazon 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기Perplexity에 물어보기Gemini에 물어보기Claude에 물어보기Grok에 물어보기

Amazon API 레퍼런스 문서 보기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요