Amazon API

Amazon API를 사용하면 제품을 검색하고 ASIN으로 상세 제품 정보를 가져올 수 있습니다. 두 엔드포인트 모두 다중 지역 타겟팅, 통화 현지화 및 기기 에뮬레이션을 지원합니다.

엔드포인트

엔드포인트	설명
`POST /api/v1/amazon/search`	정렬, 페이지 매김 및 카테고리 필터로 Amazon 제품을 검색합니다
`POST /api/v1/amazon/product`	ASIN으로 상세 제품 정보를 가져옵니다

인증

헤더	값	필수
`Authorization`	`Bearer YOUR_API_KEY`	예
`Content-Type`	`application/json`	예

제품 검색

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Amazon 제품을 검색하고 가격, 평점 및 제품 세부 정보를 포함한 구조화된 결과를 가져옵니다.

요청 본문

매개변수	유형	기본값	설명
`query`	`string`	--	필수. 검색어 (1-500자).
`domain`	`string`	`com`	Amazon 도메인 접미사 (예: `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	정렬 순서. 다음 중 하나: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	시작 페이지 번호 (1부터 시작).
`pages`	`integer`	`1`	반환할 페이지 수.
`category_id`	`string`	--	결과를 좁히기 위한 Amazon 카테고리/부서 ID.
`merchant_id`	`string`	--	특정 Amazon 판매자로 필터링.
`country`	`string`	--	지역화를 위한 국가 코드.
`language`	`string`	--	결과의 언어 코드.
`currency`	`string`	--	ISO 4217 통화 코드 (예: `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	지역화된 가격 및 재고를 위한 우편번호.
`autoselect_variant`	`boolean`	--	기본 제품 변형을 자동으로 선택합니다.

예제

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

응답 예제

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

제품 상세 정보

Bash

POST https://api.scavio.dev/api/v1/amazon/product

특정 Amazon 제품의 ASIN으로 상세 정보를 가져옵니다. 가격, 설명, 사양, 이미지, 평점 및 판매자 정보를 반환합니다.

요청 본문

매개변수	유형	기본값	설명
`query`	`string`	--	필수. Amazon ASIN (예: `B09XS7JWHH`).
`domain`	`string`	`com`	Amazon 도메인 접미사 (예: `com`, `co.uk`, `de`).
`country`	`string`	--	지역화를 위한 국가 코드.
`language`	`string`	--	결과의 언어 코드.
`currency`	`string`	--	ISO 4217 통화 코드 (예: `USD`, `EUR`).
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	지역화된 가격을 위한 우편번호.
`autoselect_variant`	`boolean`	--	기본 제품 변형을 자동으로 선택합니다.

예제

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

응답 예제

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

지원되는 도메인

domain 매개변수를 사용하여 특정 Amazon 마켓플레이스를 대상으로 지정합니다:

도메인	마켓플레이스
`com`	미국
`co.uk`	영국
`de`	독일
`fr`	프랑스
`co.jp`	일본
`ca`	캐나다
`it`	이탈리아
`es`	스페인
`in`	인도
`com.au`	호주
`com.br`	브라질
`com.mx`	멕시코

응답 형식

두 엔드포인트 모두 일관된 응답 래퍼를 반환합니다:

필드	유형	설명
`data`	`object \| null`	응답 페이로드. 요청이 업스트림에서 실패하면 `null`입니다. 검색은 `{page, products, html}`을 반환하고, 제품은 제품 객체를 직접 반환합니다.
`response_time`	`number`	서버 측 응답 시간 (밀리초)
`credits_used`	`number`	사용된 크레딧 수
`credits_remaining`	`number`	현재 결제 기간에 남은 크레딧

오류 응답

상태	설명
`401`	인증되지 않음 -- API 키가 없거나 유효하지 않음
`429`	요금제의 속도 또는 사용량 한도 초과
`502`	업스트림 오류 -- 잠시 후 재시도
`503`	업스트림을 사용할 수 없음 -- 나중에 재시도

전체 오류 참조 및 재시도 모범 사례는 오류를 참조하십시오.

Amazon API

엔드포인트

엔드포인트	설명
`POST /api/v1/amazon/search`	정렬, 페이지 매김 및 카테고리 필터로 Amazon 제품을 검색합니다
`POST /api/v1/amazon/product`	ASIN으로 상세 제품 정보를 가져옵니다

인증

헤더	값	필수
`Authorization`	`Bearer YOUR_API_KEY`	예
`Content-Type`	`application/json`	예

제품 검색

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Amazon 제품을 검색하고 가격, 평점 및 제품 세부 정보를 포함한 구조화된 결과를 가져옵니다.

요청 본문

매개변수	유형	기본값	설명
`query`	`string`	--	필수. 검색어 (1-500자).
`domain`	`string`	`com`	Amazon 도메인 접미사 (예: `com`, `co.uk`, `de`, `fr`, `co.jp`).
`sort_by`	`string`	--	정렬 순서. 다음 중 하나: `most_recent`, `price_low_to_high`, `price_high_to_low`, `featured`, `average_review`, `bestsellers`
`start_page`	`integer`	`1`	시작 페이지 번호 (1부터 시작).
`pages`	`integer`	`1`	반환할 페이지 수.
`category_id`	`string`	--	결과를 좁히기 위한 Amazon 카테고리/부서 ID.
`merchant_id`	`string`	--	특정 Amazon 판매자로 필터링.
`country`	`string`	--	지역화를 위한 국가 코드.
`language`	`string`	--	결과의 언어 코드.
`currency`	`string`	--	ISO 4217 통화 코드 (예: `USD`, `EUR`, `GBP`).
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	지역화된 가격 및 재고를 위한 우편번호.
`autoselect_variant`	`boolean`	--	기본 제품 변형을 자동으로 선택합니다.

예제

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

응답 예제

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

제품 상세 정보

Bash

POST https://api.scavio.dev/api/v1/amazon/product

특정 Amazon 제품의 ASIN으로 상세 정보를 가져옵니다. 가격, 설명, 사양, 이미지, 평점 및 판매자 정보를 반환합니다.

요청 본문

매개변수	유형	기본값	설명
`query`	`string`	--	필수. Amazon ASIN (예: `B09XS7JWHH`).
`domain`	`string`	`com`	Amazon 도메인 접미사 (예: `com`, `co.uk`, `de`).
`country`	`string`	--	지역화를 위한 국가 코드.
`language`	`string`	--	결과의 언어 코드.
`currency`	`string`	--	ISO 4217 통화 코드 (예: `USD`, `EUR`).
`device`	`string`	`desktop`	기기 유형. 다음 중 하나: `desktop`, `mobile`, `tablet`
`zip_code`	`string`	--	지역화된 가격을 위한 우편번호.
`autoselect_variant`	`boolean`	--	기본 제품 변형을 자동으로 선택합니다.

예제

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

응답 예제

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

지원되는 도메인

domain 매개변수를 사용하여 특정 Amazon 마켓플레이스를 대상으로 지정합니다:

도메인	마켓플레이스
`com`	미국
`co.uk`	영국
`de`	독일
`fr`	프랑스
`co.jp`	일본
`ca`	캐나다
`it`	이탈리아
`es`	스페인
`in`	인도
`com.au`	호주
`com.br`	브라질
`com.mx`	멕시코

응답 형식

두 엔드포인트 모두 일관된 응답 래퍼를 반환합니다:

필드	유형	설명
`data`	`object \| null`	응답 페이로드. 요청이 업스트림에서 실패하면 `null`입니다. 검색은 `{page, products, html}`을 반환하고, 제품은 제품 객체를 직접 반환합니다.
`response_time`	`number`	서버 측 응답 시간 (밀리초)
`credits_used`	`number`	사용된 크레딧 수
`credits_remaining`	`number`	현재 결제 기간에 남은 크레딧

오류 응답

상태	설명
`401`	인증되지 않음 -- API 키가 없거나 유효하지 않음
`429`	요금제의 속도 또는 사용량 한도 초과
`502`	업스트림 오류 -- 잠시 후 재시도
`503`	업스트림을 사용할 수 없음 -- 나중에 재시도

전체 오류 참조 및 재시도 모범 사례는 오류를 참조하십시오.

Amazon API

엔드포인트

인증

제품 검색

요청 본문

예제

응답 예제

제품 상세 정보

요청 본문

예제

응답 예제

지원되는 도메인

응답 형식

오류 응답

관련 항목

Amazon API

엔드포인트

인증

제품 검색

요청 본문

예제

응답 예제

제품 상세 정보

요청 본문

예제

응답 예제

지원되는 도메인

응답 형식

오류 응답

관련 항목