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

Amazon API

지역별 마켓플레이스에서 상품, 판매자 리드, 고객 의견, 카테고리 순위를 검색해 리테일 경쟁 환경을 분석합니다.

지역 도메인과 상품 링크로 상품을 찾습니다. 베스트셀러 순위는 상대적인 위치를 나타낼 뿐 절대 판매량을 의미하지 않습니다.

플랫폼 가용성

24시간 상태
정상
정상

최근 30일

제공 기능

각 Amazon 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.

기능설명1,000건당24시간 상태
검색search선택한 Amazon 마켓플레이스에서 키워드로 검색합니다.요청 1,000개당 $2.24정상
상품 상세 정보profileASIN 링크로 Amazon 상품 하나를 조회해 제목, 브랜드, 가격, 평점, 재고 상태, 주요 특징, 이미지, 베스트셀러 순위를 가져옵니다.요청 1,000개당 $1.39정상
리뷰reviewsAmazon 상품 하나의 고객 리뷰를 수집합니다.요청 1,000개당 $1.39정상
베스트셀러bestsellersAmazon Best Sellers 카테고리의 순위별 상품을 가져옵니다.요청 1,000개당 $1.39정상
판매자sellers상품 페이지나 판매자 페이지와 연결된 Amazon 판매자를 찾습니다.요청 1,000개당 $1.39정상
순위 진입 키워드ranked_keywordsasin으로 상품 하나가 순위에 오른 Amazon US 검색 키워드를 나열합니다.요청 1,000개당 $280정상
경쟁 상품product_competitorsasin 하나와 같은 검색 키워드로 경쟁하는 Amazon US 상품을 찾습니다.요청 1,000개당 $11.51정상
키워드 검색량bulk_search_volumeAmazon US에서 쇼핑객이 최대 20개 키워드를 얼마나 자주 검색하는지 요청 한 번으로 확인합니다.요청 1,000개당 $11.51정상
순위 개요rank_overview최대 20개 Amazon US 상품의 검색 노출도를 비교합니다.요청 1,000개당 $11.51정상
키워드 교집합 목록keyword_intersectionsasins에 2~10개 상품의 ASIN을 전달해, 이 상품들이 모두 순위에 오른 Amazon US 검색 키워드를 찾습니다.요청 1,000개당 $11.51일시적으로 사용 불가

기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.

Amazon 액션별로 어떤 입력을 받나요?

아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.

공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.

액션필수선택전달 방식한도1,000건당응답 필드
search

검색

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

keyworddomain, langSync 응답카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $2.24asin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · images · features · bestseller_ranks
profile

상품 상세 정보

ASIN 링크로 Amazon 상품 하나를 조회해 제목, 브랜드, 가격, 평점, 재고 상태, 주요 특징, 이미지, 베스트셀러 순위를 가져옵니다. 여기서 profile은 구매자나 판매자 프로필이 아니라 상품 페이지를 뜻하며, in_stock은 확보된 수량이 아닙니다.

urllangSync 응답—요청 1,000개당 $1.39asin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · images · features · bestseller_ranks
reviews

리뷰

Amazon 상품 하나의 고객 리뷰를 수집합니다. 각 리뷰에는 평점, 제목, 날짜, 유용성 투표 수, 옵션, 국가, 구매 인증 여부, Vine 여부가 포함됩니다. 상품 페이지에 표시되는 주요 리뷰만 가져올 수 있으며, 보통 상품당 10여 개입니다. 미국 외 스토어는 상품 링크에 맞게 domain을 설정하세요. 정렬 파라미터는 없습니다.

urldomainSync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $1.39review_id · title · text · rating · rating_scale · posted_at · helpful_count · is_verified_purchase · is_vine · variant · country · url · author_name · author_id · author_avatar_url · product_asin · platform · images
bestsellers

베스트셀러

Amazon Best Sellers 카테고리의 순위별 상품을 가져옵니다. 각 상품에는 순위, 가격, 평점, 리뷰 수, 판매 오퍼 수가 포함됩니다. keyword에 카테고리 URL이나 짧은 이름을 전달하세요. rank는 판매량이 아니라 해당 목록에서의 위치이며, 이력은 보관되지 않습니다.

keywordlangSync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $1.39id · url · name · rank · price · rating · rating_scale · review_count · offer_count · category · image_url · platform
sellers

판매자

상품 페이지나 판매자 페이지와 연결된 Amazon 판매자를 찾습니다. 사업자명, 전화번호, 주소, 평점, 연결된 상품의 ASIN·이름·가격을 가져옵니다. 일반 검색어를 넣으면 상품 검색으로 대체됩니다. 결과는 완전한 디렉터리도 아니고 사업자 인증도 아닙니다.

keywordlangSync 응답카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $1.39id · url · name · business_name · phone · address · rating · rating_scale · review_count · product_asin · product_name · product_url · product_price · product_currency · product_brand · product_rating · platform
ranked_keywords

순위 진입 키워드

asin으로 상품 하나가 순위에 오른 Amazon US 검색 키워드를 나열합니다. 각 키워드에는 월간 검색량, 해당 검색 결과 페이지에서 상품의 위치, 그 위치가 오가닉인지 스폰서인지 여부, 그 자리에 표시된 가격·평점·배지가 포함됩니다. US 마켓플레이스만 지원하며 호출당 최대 100개 키워드를 반환합니다. 모든 ASIN에 순위 키워드 데이터가 있는 것은 아니며, 데이터가 없는 ASIN은 빈 결과를 반환하고 과금되지 않습니다.

asin—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $280asin · keyword · search_volume · search_rank · result_type · result_type_rank · search_result_count · ranked_at · title · url · image_url · price · currency · rating · rating_scale · rating_count · is_amazon_choice · is_bestseller · bought_past_month · total_keywords · platform
product_competitors

경쟁 상품

asin 하나와 같은 검색 키워드로 경쟁하는 Amazon US 상품을 찾습니다. 각 경쟁 상품에는 공유 키워드 수, 해당 키워드에서의 평균 순위, 그중 오가닉 결과와 스폰서 결과로 차지한 키워드 수와 그 합산 검색량이 포함됩니다. 기본 20개, 최대 100개 경쟁 상품을 반환합니다. 행에는 제목이나 가격이 아닌 ASIN과 링크가 담깁니다.

asin—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $11.51asin · url · shared_keywords · avg_position · shared_organic_keywords · shared_organic_top10_keywords · shared_organic_search_volume · shared_sponsored_keywords · shared_sponsored_search_volume · organic_keywords · sponsored_keywords · target_asin · platform
bulk_search_volume

키워드 검색량

Amazon US에서 쇼핑객이 최대 20개 키워드를 얼마나 자주 검색하는지 요청 한 번으로 확인합니다. keywords에 배열이나 쉼표로 구분한 문자열로 전달하면, 각 행에 keyword 하나와 예상 월간 search_volume이 표시됩니다. 대소문자는 구분하지 않으며 중복 키워드는 한 번만 계산됩니다. 검색 수가 너무 적은 키워드는 행이 반환되지 않습니다.

keywords—Sync 응답—요청 1,000개당 $11.51keyword · search_volume · platform
rank_overview

순위 개요

최대 20개 Amazon US 상품의 검색 노출도를 비교합니다. asins의 ASIN마다 행이 하나씩 반환됩니다. 각 행에는 상품이 오가닉 결과와 스폰서 결과로 순위에 오른 키워드 수, 그중 1위·상위 3위·상위 10위 안에 든 키워드 수, 각 집합의 월간 검색량이 포함됩니다. 키워드 데이터가 없는 ASIN은 행이 반환되지 않습니다.

asins—Sync 응답—요청 1,000개당 $11.51asin · url · organic_keywords · organic_top1_keywords · organic_top3_keywords · organic_top10_keywords · organic_search_volume · sponsored_keywords · sponsored_top1_keywords · sponsored_top3_keywords · sponsored_top10_keywords · sponsored_search_volume · platform
keyword_intersections

키워드 교집합 목록

asins에 2~10개 상품의 ASIN을 전달해, 이 상품들이 모두 순위에 오른 Amazon US 검색 키워드를 찾습니다. 각 행은 공통 keyword 하나와 월간 search_volume이며, rankings에는 해당 검색 결과 페이지에서 각 상품의 위치(오가닉 또는 스폰서)와 가격, 평점이 표시됩니다. 기본 20개, 최대 100개 키워드를 반환합니다.

asins—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. 더 큰 limit도 허용되지만 최대 100까지만 적용됩니다.요청 1,000개당 $11.51keyword · search_volume · ranked_at · rankings · total_keywords · platform

Amazon search 파라미터는 각각 무엇을 의미하나요?

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

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
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를 사용하세요. 요청에는 해당 액션에 나열된 언어 코드만 쓸 수 있으며, 언어를 선택하면 렌더링된 콘텐츠만 바뀌고 대상 국가 스토어는 바뀌지 않습니다.
허용 값:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon profile 파라미터는 각각 무엇을 의미하나요?

ASIN 링크로 Amazon 상품 하나를 조회해 제목, 브랜드, 가격, 평점, 재고 상태, 주요 특징, 이미지, 베스트셀러 순위를 가져옵니다. 여기서 profile은 구매자나 판매자 프로필이 아니라 상품 페이지를 뜻하며, in_stock은 확보된 수량이 아닙니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
Amazon 상품 URL을 지정합니다(예: https://www.amazon.com/dp/<ASIN>). reviews 액션은 /dp/, /gp/product/, /product-reviews/ 경로에서 영문 대문자와 숫자로 된 10자리 ASIN을 추출하며, 스토어 홈페이지는 지원하지 않습니다. 이 파라미터를 사용하면 profile은 사용자 프로필 데이터가 아니라 상품 상세 페이지를 가져옵니다.
Amazon: ASIN의 정의와 확인 방법 — Amazon은 ASIN을 영숫자 10자로 된 상품 식별자로 정의하며, 상품 상세 링크의 /dp/ 뒤에서 확인할 수 있다고 안내합니다. · 확인일
lang선택
지원되는 Amazon 엔드포인트의 페이지 언어를 en, ja 같은 유효한 코드로 지정합니다. 일반 zh 코드 대신 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요. 요청에는 해당 액션에 나열된 언어 코드만 쓸 수 있으며, 언어를 선택하면 렌더링된 콘텐츠만 바뀌고 대상 국가 스토어는 바뀌지 않습니다.
허용 값:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon reviews 파라미터는 각각 무엇을 의미하나요?

Amazon 상품 하나의 고객 리뷰를 수집합니다. 각 리뷰에는 평점, 제목, 날짜, 유용성 투표 수, 옵션, 국가, 구매 인증 여부, Vine 여부가 포함됩니다. 상품 페이지에 표시되는 주요 리뷰만 가져올 수 있으며, 보통 상품당 10여 개입니다. 미국 외 스토어는 상품 링크에 맞게 domain을 설정하세요. 정렬 파라미터는 없습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
url필수
Amazon 상품 URL을 지정합니다(예: https://www.amazon.com/dp/<ASIN>). reviews 액션은 /dp/, /gp/product/, /product-reviews/ 경로에서 영문 대문자와 숫자로 된 10자리 ASIN을 추출하며, 스토어 홈페이지는 지원하지 않습니다. 이 파라미터를 사용하면 profile은 사용자 프로필 데이터가 아니라 상품 상세 페이지를 가져옵니다.
Amazon: ASIN의 정의와 확인 방법 — Amazon은 ASIN을 영숫자 10자로 된 상품 식별자로 정의하며, 상품 상세 링크의 /dp/ 뒤에서 확인할 수 있다고 안내합니다. · 확인일
domain선택
리뷰를 가져올 Amazon 국가별 스토어로, 스킴, www., 경로 없이 입력합니다. 기본값은 amazon.com이며 상품 URL의 스토어와 일치해야 합니다. 지원하는 스토어는 amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp, amazon.sg 11개뿐입니다. amazon.com.mx 같은 다른 스토어는 과금 전에 422 invalid_value로 거부되며, 오류에 지원 스토어 목록이 포함됩니다. 모든 스토어에서 reviews는 전체 리뷰 기록이 아니라 상품 페이지에 표시되는 대표 리뷰만 반환하며, 보통 상품당 약 12개입니다.
허용 값:amazon.caamazon.co.jpamazon.co.ukamazon.comamazon.com.auamazon.deamazon.esamazon.framazon.inamazon.itamazon.sg

Amazon bestsellers 파라미터는 각각 무엇을 의미하나요?

Amazon Best Sellers 카테고리의 순위별 상품을 가져옵니다. 각 상품에는 순위, 가격, 평점, 리뷰 수, 판매 오퍼 수가 포함됩니다. keyword에 카테고리 URL이나 짧은 이름을 전달하세요. rank는 판매량이 아니라 해당 목록에서의 위치이며, 이력은 보관되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
요청한 Amazon 액션에 따라 기본 검색 문자열을 지정합니다. search에서는 상품 검색어를 전달합니다. bestsellers에서는 Amazon 베스트셀러 카테고리의 전체 URL이나 경로를 만드는 데 쓰는 카테고리 약칭을 전달합니다. sellers에서는 상품 또는 판매자 페이지 URL을 전달합니다. 일반 검색어를 넣으면 판매자 ID를 직접 조회하지 않고 상품 검색 페이지를 생성합니다.
lang선택
지원되는 Amazon 엔드포인트의 페이지 언어를 en, ja 같은 유효한 코드로 지정합니다. 일반 zh 코드 대신 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요. 요청에는 해당 액션에 나열된 언어 코드만 쓸 수 있으며, 언어를 선택하면 렌더링된 콘텐츠만 바뀌고 대상 국가 스토어는 바뀌지 않습니다.
허용 값:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon sellers 파라미터는 각각 무엇을 의미하나요?

상품 페이지나 판매자 페이지와 연결된 Amazon 판매자를 찾습니다. 사업자명, 전화번호, 주소, 평점, 연결된 상품의 ASIN·이름·가격을 가져옵니다. 일반 검색어를 넣으면 상품 검색으로 대체됩니다. 결과는 완전한 디렉터리도 아니고 사업자 인증도 아닙니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
요청한 Amazon 액션에 따라 기본 검색 문자열을 지정합니다. search에서는 상품 검색어를 전달합니다. bestsellers에서는 Amazon 베스트셀러 카테고리의 전체 URL이나 경로를 만드는 데 쓰는 카테고리 약칭을 전달합니다. sellers에서는 상품 또는 판매자 페이지 URL을 전달합니다. 일반 검색어를 넣으면 판매자 ID를 직접 조회하지 않고 상품 검색 페이지를 생성합니다.
lang선택
지원되는 Amazon 엔드포인트의 페이지 언어를 en, ja 같은 유효한 코드로 지정합니다. 일반 zh 코드 대신 간체 중국어는 zhcn, 번체 중국어는 zhtw를 사용하세요. 요청에는 해당 액션에 나열된 언어 코드만 쓸 수 있으며, 언어를 선택하면 렌더링된 콘텐츠만 바뀌고 대상 국가 스토어는 바뀌지 않습니다.
허용 값:arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon ranked_keywords 파라미터는 각각 무엇을 의미하나요?

asin으로 상품 하나가 순위에 오른 Amazon US 검색 키워드를 나열합니다. 각 키워드에는 월간 검색량, 해당 검색 결과 페이지에서 상품의 위치, 그 위치가 오가닉인지 스폰서인지 여부, 그 자리에 표시된 가격·평점·배지가 포함됩니다. US 마켓플레이스만 지원하며 호출당 최대 100개 키워드를 반환합니다. 모든 ASIN에 순위 키워드 데이터가 있는 것은 아니며, 데이터가 없는 ASIN은 빈 결과를 반환하고 과금되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
asin필수
ranked_keywords 또는 product_competitors에 쓰는 Amazon ASIN 하나로, 영문 대문자 또는 숫자 10자입니다(예: B0C2JXSHSK). 목록이나 쉼표로 구분한 ASIN은 거부됩니다. 미국 마켓플레이스(amazon.com)만 지원하므로 다른 스토어의 ASIN은 데이터를 반환하지 않습니다.

Amazon product_competitors 파라미터는 각각 무엇을 의미하나요?

asin 하나와 같은 검색 키워드로 경쟁하는 Amazon US 상품을 찾습니다. 각 경쟁 상품에는 공유 키워드 수, 해당 키워드에서의 평균 순위, 그중 오가닉 결과와 스폰서 결과로 차지한 키워드 수와 그 합산 검색량이 포함됩니다. 기본 20개, 최대 100개 경쟁 상품을 반환합니다. 행에는 제목이나 가격이 아닌 ASIN과 링크가 담깁니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
asin필수
ranked_keywords 또는 product_competitors에 쓰는 Amazon ASIN 하나로, 영문 대문자 또는 숫자 10자입니다(예: B0C2JXSHSK). 목록이나 쉼표로 구분한 ASIN은 거부됩니다. 미국 마켓플레이스(amazon.com)만 지원하므로 다른 스토어의 ASIN은 데이터를 반환하지 않습니다.

Amazon bulk_search_volume 파라미터는 각각 무엇을 의미하나요?

Amazon US에서 쇼핑객이 최대 20개 키워드를 얼마나 자주 검색하는지 요청 한 번으로 확인합니다. keywords에 배열이나 쉼표로 구분한 문자열로 전달하면, 각 행에 keyword 하나와 예상 월간 search_volume이 표시됩니다. 대소문자는 구분하지 않으며 중복 키워드는 한 번만 계산됩니다. 검색 수가 너무 적은 키워드는 행이 반환되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keywords필수
bulk_search_volume에 쓰는 키워드로, 1~20개를 배열이나 쉼표로 구분한 문자열로 전달합니다. 각 키워드는 최대 80자, 10단어까지이며, 예를 들면 standing desk입니다. 대소문자는 구분하지 않으며 중복된 키워드는 한 번으로 셉니다. Amazon 미국 검색량만 지원하며, 키워드가 20개를 넘거나 너무 긴 키워드가 있으면 호출이 실행되기 전에 거부됩니다.

Amazon rank_overview 파라미터는 각각 무엇을 의미하나요?

최대 20개 Amazon US 상품의 검색 노출도를 비교합니다. asins의 ASIN마다 행이 하나씩 반환됩니다. 각 행에는 상품이 오가닉 결과와 스폰서 결과로 순위에 오른 키워드 수, 그중 1위·상위 3위·상위 10위 안에 든 키워드 수, 각 집합의 월간 검색량이 포함됩니다. 키워드 데이터가 없는 ASIN은 행이 반환되지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
asins필수
rank_overview(1~20개) 또는 keyword_intersections(2~10개)에 쓰는 ASIN으로, 배열이나 쉼표로 구분한 문자열로 전달합니다. 각 ASIN은 영문 대문자 또는 숫자 10자입니다(예: B0C2JXSHSK). 미국 마켓플레이스(amazon.com)만 지원합니다. rank_overview에서는 ASIN마다 행이 하나씩 생기며, 키워드 데이터가 없는 ASIN은 제외됩니다. keyword_intersections에서는 각 행이 모든 상품이 순위에 오른 키워드입니다. 개수가 이 범위를 벗어나면 호출이 실행되기 전에 거부됩니다.

Amazon keyword_intersections 파라미터는 각각 무엇을 의미하나요?

asins에 2~10개 상품의 ASIN을 전달해, 이 상품들이 모두 순위에 오른 Amazon US 검색 키워드를 찾습니다. 각 행은 공통 keyword 하나와 월간 search_volume이며, rankings에는 해당 검색 결과 페이지에서 각 상품의 위치(오가닉 또는 스폰서)와 가격, 평점이 표시됩니다. 기본 20개, 최대 100개 키워드를 반환합니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
asins필수
rank_overview(1~20개) 또는 keyword_intersections(2~10개)에 쓰는 ASIN으로, 배열이나 쉼표로 구분한 문자열로 전달합니다. 각 ASIN은 영문 대문자 또는 숫자 10자입니다(예: B0C2JXSHSK). 미국 마켓플레이스(amazon.com)만 지원합니다. rank_overview에서는 ASIN마다 행이 하나씩 생기며, 키워드 데이터가 없는 ASIN은 제외됩니다. keyword_intersections에서는 각 행이 모든 상품이 순위에 오른 키워드입니다. 개수가 이 범위를 벗어나면 호출이 실행되기 전에 거부됩니다.

Amazon API 사용 방법

  1. 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
  2. 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
  3. 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
  4. 04애플리케이션에 필요한 응답 필드를 저장합니다.
amazon_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"amazon","action":"search","params":{"keyword":"<keyword>"}}'

Amazon 가이드

이 액션을 활용한 실제 예제와 방법입니다. 먼저 이 페이지에서 현재 액션, 파라미터, 필드를 확인하세요. 글에 나온 예제와 제한 사항은 최신 카탈로그를 대신할 수 없습니다.

Build

Amazon 리뷰 API: 상품 링크에서 원문 근거를 갖춘 문제 목록까지

Amazon 리뷰를 읽는 단계별 연동 방법을 다룹니다. 국가별 마켓플레이스와 상품 식별자를 검증하고, 리뷰·변형 상품·관측 로그를 분리하고, 중복 제거와 누락 데이터를 처리하며, 검증 가능한 원문 발췌를 근거로 문제 분류를 구성합니다.

글 읽기
Blog

Amazon 가격 모니터링이 오탐을 내는 이유: 오퍼 식별부터 확인해야 합니다

Amazon 스크래핑은 가격 하나를 저장하는 것으로 끝나지 않습니다. 이 글은 공식 카탈로그와 가격 모델을 바탕으로 ASIN 변형, 판매자, 배송비, 프로모션 조건, 재고 상태, 관측 시각이 가격 비교에 어떤 영향을 주는지 설명합니다.

글 읽기
Blog

가격 스크래핑의 상업화: 판매자가 구독을 갱신하는 가격 모니터링 제품 만들기

판매자는 왜 가격 모니터링에 돈을 내고, 왜 구독을 해지할까요? 상품 매칭, 예외 목록, 가격 승인 워크플로를 통해 가격 데이터 제공 방식, 과금 단위, 파일럿 인수 기준을 살펴봅니다.

글 읽기

Amazon API 자주 묻는 질문

Amazon API로 무엇을 가져올 수 있나요?

platform을 amazon 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 상품 상세 정보, 리뷰, 베스트셀러, 판매자 및 more입니다. 각 액션 이름은 서로 다른 Amazon 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.

Amazon에 공식 API가 있나요?

Amazon의 Product Advertising API 5.0은 지원이 중단되어 Creators API로 대체되었습니다. Creators API는 최근 30일간 적격 판매가 10건 이상인 Amazon Associates 회원이 이용할 수 있습니다. Selling Partner API는 판매자, 벤더와 이들이 승인한 개발자를 위한 것으로, 주문과 재고 같은 자체 비즈니스 데이터를 다룹니다.

공식 출처: Amazon Associates: PA-API 5.0 deprecation · Amazon Associates: Creators API introduction · Amazon: what is the Selling Partner API · 확인일

Amazon 개발자 계정이나 API 키가 필요한가요?

아니요. 요청은 EveryInfra API 키를 사용해 EveryInfra를 통해 전송됩니다. 회원가입 후 콘솔에서 키를 생성하고 Authorization: Bearer <API_KEY> 형식으로 보내면 됩니다. Amazon 개발자 앱을 등록하거나, Amazon API 접근을 신청하거나, Amazon 계정으로 로그인할 필요가 없으며, 액션은 공개된 Amazon 데이터만 반환합니다.

Amazon API 요금은 요청 1,000건당 얼마인가요?

액션에 따라 요청 1,000개당 $1.39부터이며, 각 액션의 가격은 이 페이지의 표와 공개 카탈로그에서 확인할 수 있습니다. 구독제가 아니며, USD 잔액을 충전한 뒤 API 호출당 비용을 지불합니다. 실패한 호출과 빈 결과에는 과금되지 않습니다.

Amazon search 요청에는 어떤 입력이 필요한가요?

요청한 Amazon 액션에 따라 기본 검색 문자열을 지정합니다. search에서는 상품 검색어를 전달합니다. bestsellers에서는 Amazon 베스트셀러 카테고리의 전체 URL이나 경로를 만드는 데 쓰는 카테고리 약칭을 전달합니다. sellers에서는 상품 또는 판매자 페이지 URL을 전달합니다. 일반 검색어를 넣으면 판매자 ID를 직접 조회하지 않고 상품 검색 페이지를 생성합니다. params 안의 keyword 필드로 전달하세요.

Amazon search 액션은 어떤 필드를 반환하나요?

선언된 스키마에 포함된 필드는 asin, title, brand 및 price입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.

모든 Amazon 액션이 즉시 결과를 반환하나요?

비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.