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

EveryInfra
검색⌘K
한국어
로그인무료로 시작하기

Google Shopping API

Google Shopping은 Google이 찾은 상품과 판매처별 판매 정보를 보여줍니다. search는 검색어에 대해 가격, 판매처, 평점, 리뷰 수, 이미지, 상품 ID가 담긴 상품을 최대 100개 반환합니다.

가격은 country(기본값 us)로 지정한 시장을 따르므로 통화도 그에 따라 바뀝니다. price는 price_text에서 추출한 숫자입니다. min_price와 max_price로 결과를 좁히거나 sort로 가격순 또는 평점순으로 정렬합니다.

무료로 시작하기 문서

플랫폼 가용성

24시간 상태
정상
정상

최근 30일

제공 기능

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

기능설명1,000건당24시간 상태
검색searchkeyword로 Google Shopping을 검색해 가격과 할인 전 가격, 판매처, 평점, 리뷰 수, 이미지, Google 제품 ID가 포함된 제품을 최대 100개 가져옵니다.요청 1,000개당 $0.56정상

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

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

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

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

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

검색

keyword로 Google Shopping을 검색해 가격과 할인 전 가격, 판매처, 평점, 리뷰 수, 이미지, Google 제품 ID가 포함된 제품을 최대 100개 가져옵니다. country로 시장을 설정하고, 가격대로 필터링하며, 가격순이나 평점순으로 정렬할 수 있습니다.

keywordcountry, language, max_price, min_price, sortSync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $0.56rank · title · product_id · offer_id · image_id · price_text · price · old_price_text · old_price · merchant · multiple_merchants · rating · rating_scale · review_count · image_url · url · platform

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

keyword로 Google Shopping을 검색해 가격과 할인 전 가격, 판매처, 평점, 리뷰 수, 이미지, Google 제품 ID가 포함된 제품을 최대 100개 가져옵니다. country로 시장을 설정하고, 가격대로 필터링하며, 가격순이나 평점순으로 정렬할 수 있습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
상품 검색어입니다(예: wireless earbuds).
country선택
검색할 Google Shopping 마켓의 두 글자 국가 코드입니다(예: us, gb, de, 기본값 us). 가격은 해당 마켓의 통화로 표시됩니다.
language선택
제목과 레이블에 사용할 두 글자 언어 코드입니다(예: en, de, 기본값 en).
max_price선택
포함할 최고 가격으로, min_price보다 작을 수 없습니다.
min_price선택
포함할 최저 가격으로, country 마켓의 통화 기준이며 0 이상입니다.
Google 판매자 센터: 제품 데이터 사양의 가격과 할인가 — Google 판매자 센터의 제품 데이터 사양에 따르면 판매자는 제목, 가격, 선택 속성인 sale_price 등의 속성을 포함해 제품을 제출하며, Google은 이 데이터로 제품을 검색어와 연결합니다. 이 자료는 Google 쇼핑 가격이 판매자의 제품 데이터에서 나오며 정가와 할인가를 구분한다는 점만 확인해 줍니다. 이 API의 `min_price`와 `max_price`는 검색 대상 국가의 통화를 기준으로 결과를 필터링하며 EveryInfra가 정의한 것입니다. 이 자료는 해당 필터나 결과 수를 보증하지 않습니다. · 확인일
sort선택
정렬 순서로, price_low(가격 낮은 순), price_high(가격 높은 순), rating(평점 높은 순) 중 하나입니다. 생략하면 관련성 순으로 정렬합니다.

Google Shopping API 사용 방법

  1. 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
  2. 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
  3. 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
  4. 04애플리케이션에 필요한 응답 필드를 저장합니다.
google_shopping_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":"google_shopping","action":"search","params":{"keyword":"<keyword>"}}'

Google Shopping API 자주 묻는 질문

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

platform을 google_shopping 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색입니다. 각 액션 이름은 서로 다른 Google Shopping 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.

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

상품 검색어입니다(예: wireless earbuds). params 안의 keyword 필드로 전달하세요.

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

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

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

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

1688 APIAliExpress APIAmazon APICraigslist APIDewu APIeBay APIEtsy APIJD.com API공개 카탈로그 보기