자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Amazon 검색 API

POST

API 상태

24시간 상태
정상
24시간 평균 소요 시간
—
  • 양호 / 정상
  • 사용 가능
  • 제한적
  • 대부분 작동 중단
정상

선택한 Amazon 마켓플레이스에서 키워드로 검색합니다. 각 상품의 ASIN, 브랜드, 가격과 정가, 평점 수, 재고 상태, 판매자를 가져옵니다. amazon.co.uk처럼 domain으로 스토어를 지정하고, 가격은 해당 스토어 기준으로 확인하세요. lang만으로는 국가가 바뀌지 않습니다.

Amazon 검색은 keyword로 상품을 찾아 각 상품의 ASIN, 제목, 브랜드, 가격과 정가, 평점과 평점 수, 재고 상태, 카테고리, 이미지, 판매자, Amazon's Choice 배지 여부를 반환합니다. 키워드로 어떤 상품이 어떤 가격과 평점으로 노출되는지 파악할 때 사용하며, 크로스보더 상품 리서치, 경쟁사 가격 조사, 해당 키워드의 시장 파악에 활용할 수 있습니다.

domain(예: amazon.co.uk)으로 국가별 스토어를, lang으로 페이지 언어를 선택합니다. 중국어 간체와 번체는 zhcn과 zhtw입니다. 언어를 선택해도 스토어는 바뀌지 않습니다. 더 자세히 보려면 asin으로 상품 링크를 만들어 Amazon 상세 또는 리뷰 기능에 전달하십시오. rating_count가 적은 평점은 큰 의미가 없다는 점도 염두에 두십시오.

요금은 요청 1,000개당 $2.24(호출당 $0.002236)입니다. 실패한 호출과 빈 결과에는 과금하지 않습니다. 동기 방식입니다. 오래 걸리는 작업은 요청 본문에 "mode": "async"를 추가하고 job_id를 받아 폴링하세요.

AI 프롬프트

EveryInfra Amazon 검색 엔드포인트(amazon/search)를 사용하는 데이터 수집 스크립트 작성을 도와주세요.

엔드포인트 사용 방법:
- 요청: Authorization: Bearer <API 키> 헤더와 함께 POST https://api.everyinfra.com/api/v1/social로 보냅니다. 키는 EVERYINFRA_API_KEY 환경 변수에서 읽고, 절대 하드코딩하지 마세요.
- 요청 본문에서 platform은 amazon, action은 search로 설정하고, 파라미터는 params 안에 넣습니다.
- 필수 파라미터:
  - keyword: 요청한 Amazon 액션에 따라 기본 검색 문자열을 지정합니다. search에서는 상품 검색어를 전달합니다. bestsellers에서는 Amazon 베스트셀러 카테고리의 전체 URL이나 경로를 만드는 데 쓰는 카테고리 약칭을 전달합니다. sellers에서는 상품 또는 판매자 페이지 URL을 전달합니다. 일반 검색어를 넣으면 판매자 ID를 직접 조회하지 않고 상품 검색 페이지를 생성합니다.
- 선택 파라미터:
  - domain: 스킴이나 경로 없이 Amazon 국가 도메인을 지정합니다(예: amazon.com, amazon.co.uk, amazon.co.jp). 기본값은 amazon.com이며, search 액션은 이 값으로 해당 스토어의 검색 URL을 만듭니다.
  - lang: 지원되는 Amazon 엔드포인트의 페이지 언어를 en, ja 같은 유효한 코드로 지정합니다. 일반 zh 코드 대신 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요. 요청에는 해당 액션에 나열된 언어 코드만 쓸 수 있으며, 언어를 선택하면 렌더링된 콘텐츠만 바뀌고 대상 국가 스토어는 바뀌지 않습니다. (허용 값: ar / bn / cs / da / de / en / es / fr)
  - limit: 이 호출에서 반환할 최대 행 수로, 1~50 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다. (기본값: 10)
- 레코드 목록을 반환합니다. 각 레코드의 주요 필드: asin (Amazon 표준 식별 번호(Amazon Standard Identif…), title, url, brand (브랜드입니다), price, list_price (정가(취소선 가격)입니다), currency, rating, rating_scale, rating_count, in_stock (재고 보유 여부입니다), category; 전체 필드 19개, 전체 목록은 https://api.everyinfra.com/api/v1/social/catalog?platform=amazon.
- 요청 본문 예시:
{
  "platform": "amazon",
  "action": "search",
  "params": {
    "keyword": "coffee grinder"
  }
}
- 요금: 요청 1,000개당 $2.24. 실패하거나 빈 결과에는 과금하지 않습니다.
- 대상이 수십~수백 개라면 요청 본문에 "mode": "async"를 추가하세요. job_id를 즉시 받은 뒤 GET https://api.everyinfra.com/api/v1/jobs/{job_id}를 폴링해 결과를 가져옵니다.
- 422가 반환되면 오류에 제시된 파라미터 이름과 허용 값을 참고해 요청을 수정하고, 429 또는 503이 반환되면 Retry-After만큼 기다린 뒤 다시 시도합니다.

코드를 작성하기 전에 필요한 대상과 수량, 필드, 원하는 출력 형식을 먼저 물어봐 주세요. 그런 다음 계획과 대략적인 비용을 저와 확인해 주세요.

요청 파라미터

이름위치타입필수기본값설명
Authorizationheaderstring예-Bearer 뒤에 API 키를 붙여 입력합니다. API 키는 콘솔에서 생성하며, URL이나 코드 저장소에 절대 넣지 마세요.
platformbodystring예amazon플랫폼 식별자이며 고정값입니다.
actionbodystring예search기능 식별자이며 고정값입니다.
keywordbody.paramsstring예-요청한 Amazon 액션에 따라 기본 검색 문자열을 지정합니다. search에서는 상품 검색어를 전달합니다. bestsellers에서는 Amazon 베스트셀러 카테고리의 전체 URL이나 경로를 만드는 데 쓰는 카테고리 약칭을 전달합니다. sellers에서는 상품 또는 판매자 페이지 URL을 전달합니다. 일반 검색어를 넣으면 판매자 ID를 직접 조회하지 않고 상품 검색 페이지를 생성합니다.
domainbody.paramsstring아니요-스킴이나 경로 없이 Amazon 국가 도메인을 지정합니다(예: amazon.com, amazon.co.uk, amazon.co.jp). 기본값은 amazon.com이며, search 액션은 이 값으로 해당 스토어의 검색 URL을 만듭니다.
langbody.paramsstring (enum)아니요-지원되는 Amazon 엔드포인트의 페이지 언어를 en, ja 같은 유효한 코드로 지정합니다. 일반 zh 코드 대신 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요. 요청에는 해당 액션에 나열된 언어 코드만 쓸 수 있으며, 언어를 선택하면 렌더링된 콘텐츠만 바뀌고 대상 국가 스토어는 바뀌지 않습니다.허용 값arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw
limitbody.paramsinteger (1–50)아니요10이 호출에서 반환할 최대 행 수로, 1~50 사이의 정수입니다. 생략하면 기본값이 적용되며, 실제 반환되는 행은 이보다 적을 수 있습니다. 더 큰 값을 지정하면 과금 전에 422를 반환합니다.

코드 샘플

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "amazon",
  "action": "search",
  "params": {
    "keyword": "coffee grinder"
  }
}'

OpenAPI 정의(JSON)샘플 코드는 EVERYINFRA_API_KEY 환경 변수에서 키를 읽으므로, 복사한 코드에는 API 키가 포함되지 않습니다.

응답 예시

실제 응답

September 26, 2026 at 08:56(UTC)에 위 코드 샘플의 파라미터로 이 API를 호출해 수집한 응답입니다. results와 count는 해당 호출의 실제 응답이며, 개인정보(이름, 핸들, 아바타, 프로필 링크, 연락처)는 제거했습니다(목록은 처음 2개만 표시). id, billing, quota는 호출할 때마다 달라지므로 형태만 표시합니다.

json
{
  "id": "req_…",
  "platform": "amazon",
  "action": "search",
  "results": [
    {
      "asin": "B0GWHGT8C6",
      "title": "SHARDOR Burr Coffee Grinder Electric with 32 Grinding Sizes, 2026 Upgraded",
      "url": "https://www.amazon.com/dp/B0GWHGT8C6",
      "brand": "SHARDOR",
      "price": 39.98,
      "list_price": 49.99,
      "currency": "$",
      "rating": 4.4,
      "rating_count": 23,
      "in_stock": true,
      "category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
      "image_url": "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SY300_SX300_QL70_FMwebp_.jpg",
      "is_amazon_choice": false,
      "seller_name": "KDSXG",
      "platform": "amazon",
      "images": [
        "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71WkUEs07pL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/71h+360x8gL._AC_SL1500_.jpg"
      ],
      "features": [
        "CONSISTENT DAILY GRINDING Designed for home coffee routines, this flat burr grinder helps prepare beans for drip, pour over, french press, cold brew, moka pot, and espresso style drinks. The compact body fits small counters, apartments, office corners, and coffee stations without…",
        "SMALL BATCH CONTROL The adjustable time based grinding design lets users grind only what they need for fresh cups, single serve brewers, or family coffee prep. To help protect the motor, the built in safety program supports up to 120 seconds of continuous operation before a short…",
        "32 SIZE OPTIONS Choose from 32 grind settings to match different brewing needs, from finer grounds for espresso style preparation to coarser grounds for french press and cold brew. The grinder includes a chamber, cleaning brush, and hopper for daily use and simple upkeep."
      ],
      "bestseller_ranks": [
        {
          "rank": 19549,
          "category": "Home & Kitchen"
        },
        {
          "rank": 7,
          "category": "Burr Coffee Grinders"
        }
      ],
      "rating_scale": 5
    },
    {
      "asin": "B0HB98V4SP",
      "title": "Flat Burr Coffee Grinder Electric, Adjustable Coffee Bean Grinder with 17 Grinding Sizes, Burr Mill for Espresso & French Press, 2-12 Cup, Silver",
      "url": "https://www.amazon.com/dp/B0HB98V4SP",
      "brand": "Rounexes",
      "price": 39.99,
      "currency": "$",
      "rating": 5,
      "rating_count": 17,
      "in_stock": true,
      "category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
      "image_url": "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SY300_SX300_QL70_FMwebp_.jpg",
      "is_amazon_choice": false,
      "seller_name": "MeiDing",
      "platform": "amazon",
      "images": [
        "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/81khWIt-ThL._AC_SL1500_.jpg",
        "https://m.media-amazon.com/images/I/712ulwCFZuL._AC_SL1500_.jpg"
      ],
      "features": [
        "[17 Precise Grind Settings] From fine espresso to coarse French press, dial in the perfect grind across 17 calibrated levels—ideal for drip, pour-over, or cold brew, and designed to unlock your beans’ full aroma every morning.",
        "[Uniform Flat Burr & Anti-Overheating] Heavy-duty stainless steel flat burrs ensure even grinding for consistent extraction and richer flavor. Low-speed operation prevents overheating, preserving delicate oils and freshness.",
        "[2–12 Cup Quantity Control] Set your desired yield (2–12 cups) with the intuitive cup selector knob and 7 oz. bean hopper—grind just what you need, with zero waste."
      ],
      "bestseller_ranks": [
        {
          "rank": 68800,
          "category": "Home & Kitchen"
        },
        {
          "rank": 28,
          "category": "Burr Coffee Grinders"
        }
      ],
      "rating_scale": 5
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

응답 필드

비즈니스 데이터는 results에 담깁니다. 아래 표는 레코드에 포함될 수 있는 필드를 나열하며, 플랫폼에 표시되지 않는 값을 임의로 만들어 넣지 않습니다.

필드의미
asinAmazon 표준 식별 번호(Amazon Standard Identification Number)로, 스토어 내 상품의 고유 ID입니다.
title제목입니다. 플랫폼에 제목이 없으면 null입니다(예: 텍스트 전용 게시물).
url플랫폼에서 해당 레코드로 연결되는 링크입니다.
brand브랜드입니다.
price통화 기호 없이 숫자로 표시한 가격입니다. currency를 참고하세요.
list_price정가(취소선 가격)입니다.
currency가격의 통화 코드입니다(예: CNY, USD). price는 있는데 currency가 null이면 통화를 추정하지 마세요.
rating평점입니다. 척도는 플랫폼마다 다릅니다. 같은 행의 rating_scale이 최댓값을 나타냅니다(보통 5이며, Booking, Douban, iQIYI, NAVER는 10). 플랫폼 간에 비교하기 전에 rating_scale로 환산하세요. 그렇지 않으면 비교 결과가 뒤바뀔 수 있습니다.
rating_scale같은 행에 있는 rating의 최댓값입니다. 5점 척도는 5, 10점 척도는 10입니다. 행에 rating이 있을 때만 포함됩니다.
rating_count평가한 사람 수입니다. null은 비공개라는 뜻이며, 0이 아닙니다.
in_stock재고 보유 여부입니다.
category플랫폼 자체 분류 체계의 카테고리 이름으로, 플랫폼 간에 정규화되지 않습니다.
image_url이미지 링크입니다. 이미지가 여러 개인 기능은 image_urls 배열을 반환할 수 있습니다.
description요약 또는 설명으로, 보통 text보다 짧습니다.
is_amazon_choice상품에 Amazon's Choice 배지가 있는지 여부입니다.
seller_name판매자 이름입니다.
platform출처 플랫폼 식별자로, 요청의 platform과 같습니다(예: xiaohongshu, tiktok).
images플랫폼 표시 순서대로 나열된 이미지 링크 배열입니다. 이미지가 없으면 필드가 생략됩니다.
features상품 페이지의 글머리표 특징 목록(search, profile)으로, 작성된 그대로입니다. 없으면 생략됩니다.
bestseller_ranksBest Sellers 순위(search, profile)입니다. 각 항목에 rank와 category가 있으며 카테고리마다 항목 하나씩입니다. 조회 시점의 순위이며 판매량이 아닙니다.

FAQ

다른 국가 스토어는 어떻게 검색하나요?

domain에 amazon.co.uk나 amazon.co.jp 같은 스토어 도메인을 https://나 경로 없이 전달하십시오. 기본값은 amazon.com입니다. lang은 페이지 언어만 바꾸며 스토어를 바꾸지 않습니다.

lang에는 어떤 값을 넣을 수 있나요?

이 기능에 나열된 언어 코드(예: en, ja, de)만 사용할 수 있습니다. 중국어 간체는 zhcn, 번체는 zhtw이며, zh만 단독으로 쓰면 허용되지 않습니다. 언어는 페이지 텍스트를 바꿀 뿐 검색하는 스토어를 바꾸지 않습니다.

찾은 상품의 리뷰는 어떻게 가져오나요?

asin으로 https://www.amazon.com/dp/<ASIN> 같은 상품 링크를 만들어 Amazon 리뷰 기능에 전달하십시오. 검색한 스토어를 그대로 사용하고, 미국 외 스토어라면 리뷰 기능에도 같은 domain을 보내십시오. 그렇지 않으면 amazon.com에서 리뷰를 읽어와 결과가 맞지 않습니다.

오류 및 과금

401
키가 없거나 유효하지 않습니다.
402
잔액이 부족합니다. 먼저 충전하세요.
422
파라미터 이름 또는 값이 올바르지 않습니다. 오류에 제시된 제안을 참고해 수정하세요. 과금되지 않습니다.
429
분당 요청 속도 제한에 도달했습니다. Retry-After만큼 기다린 뒤 다시 시도하세요.
503
처리를 완료하지 못했습니다. 보류된 금액은 잔액으로 반환됩니다. 결과가 불확실하면 재시도하기 전에 먼저 확인하세요.
200 빈 결과
데이터가 없습니다. 과금되지 않습니다.

오류