상품 검색
5 크레딧/v1/google_shopping/product-searchGoogle Shopping 키워드 검색입니다. 상품 카드와 상세용 불투명 id(product_id, gid, data_docid)를 반환합니다. 첫 호출은 약 20-30초일 수 있습니다. 고급 티어(5 크레딧)입니다.
query, country, language, depth, price_min, price_max, sort_by
Google Shopping APIGoogle Shopping 상품 데이터 API
SocialCrawl API 키로 Google Shopping 검색, 상품 상세, 리뷰, 판매자를 구조화 JSON으로 가져옵니다. 공유 커머스 스키마입니다. 호출은 크레딧으로 과금됩니다.
/v1/google_shopping
활성 엔드포인트는 5개입니다. 검색은 고급 티어입니다.
- GET /v1/google_shopping/product-search
- GET /v1/google_shopping/product
- GET /v1/google_shopping/reviews
- GET /v1/google_shopping/sellers
- GET /v1/google_shopping/price-history
Google Shopping 엔드포인트
Google Shopping 읽기 엔드포인트는 5개입니다. 키워드 검색이 product, reviews, sellers, price-history용 id를 줍니다. 데이터 API만 지원하며 작업 폴링은 서버가 처리합니다.
상품 상세
1 크레딧/v1/google_shopping/productproduct-search가 준 id로 상품 상세를 가져옵니다. product_id, gid, data_docid 중 하나를 전달합니다. 표준 티어(1 크레딧)입니다.
product_id or gid or data_docid, country, language
상품 리뷰
1 크레딧/v1/google_shopping/reviewsGoogle Shopping 상품 리뷰입니다. 검색에서 받은 gid를 권장합니다. 표준 티어(1 크레딧)입니다.
gid, product_id, data_docid, depth, country, language
판매자
1 크레딧/v1/google_shopping/sellers검색 id 기준 판매자·오퍼 목록입니다. 표준 티어(1 크레딧)입니다.
product_id or gid or data_docid, country, language
가격 이력
1 크레딧/v1/google_shopping/price-historyproduct-search의 product_id로 스토어별 날짜-가격 이력을 조회합니다. 현재 목록가가 아니라 시계열입니다.
product_id, country
Google Shopping API5개 엔드포인트 지원
문서 보기키워드와 맞는 Google 쇼핑 상품을 돌려줍니다. 제목과 판매자, 현재가와 정가, 별점, 이미지, 상세 조회에 필요한 id가 담깁니다.
product와 reviews, sellers 모두 여기서 나오는 id를 요구하니 Google 쇼핑은 이 엔드포인트부터 두드리세요.
5크레딧
GET/v1/google_shopping/product-search?query=wireless+earbuds
query · Product search keyword (e.g. 'wireless earbuds').
$ curl https://www.socialcrawl.dev/v1/google_shopping/product-search?query=wireless+earbuds \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Google Shopping API 동작
Google Shopping도 다른 SocialCrawl 데이터 엔드포인트와 같습니다. API 키로 GET /v1/google_shopping/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 공개 읽기에 Google Shopping OAuth 앱은 필요 없습니다. SocialCrawl 전 플랫폼에 같은 키를 사용합니다.
GET과 쿼리 파라미터
Google Shopping 라우트는 모두 GET입니다. query, product_id, gid, data_docid, country, language, depth를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.
크레딧 과금
product-search는 5 크레딧입니다. product, reviews, sellers는 1 크레딧입니다. 첫 작업은 수십 초일 수 있으며 이후 캐시됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. 페이지가 있는 목록 응답은 페이지네이션 필드를 가집니다.
연동 순서
대부분 제품은 엔티티를 먼저 찾은 뒤 필요할 때만 상세와 리뷰를 깊게 봅니다.
01검색
GET /v1/google_shopping/product-search?query=…product_id, gid, data_docid가 있는 ProductList
모든 심화 호출에 id가 필요합니다.
02상품
GET /v1/google_shopping/product?product_id=…불투명 id의 상품 상세
검색 카드는 전체 상품 레코드가 아닙니다.
03리뷰
GET /v1/google_shopping/reviews?gid=…상품 ReviewList
Shopping 리뷰 VoC입니다.
04판매자
GET /v1/google_shopping/sellers?product_id=…오퍼 SellerList
복수 머천트 가격 행입니다.
요청
GET /v1/google_shopping/product-search?query=wireless+earbuds
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/google_shopping/product?product_id=1749519698216963169
GET /v1/google_shopping/reviews?gid=3591805395819257241응답 봉투
{
"success": true,
"data": {
"items": [
{
"product": {
"id": "1749519698216963169",
"title": "Example earbuds",
"price": { "current": 39.99, "currency": "USD" },
"rating": 4.4,
"ext": { "gid": "3591805395819257241" }
}
}
]
},
"credits_used": 5,
"credits_remaining": 9995,
"request_id": "req_…",
"cached": false
}data 형태
아키타입이 맞는 범위에서 필드 이름은 SocialCrawl 나머지와 같습니다. 한 번 파싱해 플랫폼에 재사용합니다.
Productproduct
id, title, price, rating, images, ext ids
ProductListproduct-search
심화 레그에 필요한 id가 있는 items[]
ReviewListreviews
items[]에 rating, text, author
SellerListsellers
머천트 오퍼 행
게이트웨이 내부
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Google Shopping은 사이드카가 아닙니다.
- 01
엣지가 호출을 받음
Next.js catch-all이 Hono 소셜 API로 라우팅합니다. request_id를 만들고 키를 인증한 뒤 분당 600회, 키당 동시 50개 한도를 적용합니다.
- 02
검증 후 차감
레지스트리에서 google_shopping/product-search (or product, reviews, sellers)를 찾습니다. 필수 파라미터와 형식 검사를 먼저 합니다. 잘못된 입력은 과금 없이 400입니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 수집
platform + resource + params로 캐시 키를 만듭니다. 히트면 credits_used = 0으로 즉시 반환합니다. 미스면 작업 수명주기를 서버에서 스핀 폴링합니다. 소스가 불안정하면 5xx/네트워크 재시도와 서킷 브레이커를 사용합니다.
- 04
정규화 후 반환
업스트림 JSON을 Product, ProductList, ReviewList, SellerList, App, PlaceList 등 커머스 아키타입으로 매핑하고 Zod로 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.
운영에서 중요한 과금 규칙
- product-search 라이브 미스: 5 크레딧
- product / reviews / sellers: 1 크레딧
- 캐시 히트: 0 크레딧
- 빈 응답 / 하드 실패: 자동 환불
- 잘못된 파라미터: 400, 과금 없음
- 크레딧 부족: 402, 과금 없음
- 콜드 검색은 약 20-30초 가능
- 심화는 검색 id만 사용
- 광고·Merchant Center 쓰기 API 없음
데이터 수집 방식
Google Shopping은 공개 읽기 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 벤더 SDK를 배울 필요가 없습니다.
이 API에서 Google Shopping의 의미
공개 Shopping 검색, 상품 정보, 리뷰, 판매자 오퍼입니다. 읽기 전용입니다.
SocialCrawl 수집 경로
쇼핑 조회는 서버 측 작업으로 실행됩니다. 비동기 수명주기는 숨기고 동기 HTTP 한 번으로 받습니다.
엣지에서 나가는 형태
불투명 id가 있는 ProductList, 이어 Product, ReviewList, SellerList입니다.
라이브로 제공하지 않는 것
Merchant Center 관리, 광고, 피드 업로드는 없습니다.
필드 매핑
search hit→ product + ext idsproduct_id, gid, data_docid
reviews task→ ReviewListgid 권장
sellers task→ SellerListproduct와 동일 id
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
5active Google Shopping endpoints in the registry
1 / 5product·reviews·sellers와 product-search 크레딧 구간
복수 머천트 가격·리뷰 조사
호출은 항상 product-search에서 시작합니다. product, reviews, sellers는 그 응답의 id가 필요합니다. 서버 측 작업으로 Shopping 검색을 동기 호출한 뒤 product, reviews, sellers를 1 크레딧으로 심화합니다.
콜드 product-search는 약 20-30초인 경우가 많습니다. 캐시된 심화 호출은 보통 수 초입니다.
Google Shopping API 활용 사례
Google Shopping 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
가격 인텔리전스
Python, workersproduct-search 후 sellers로 복수 머천트 견적을 봅니다.
VoC 팀
Node, BIgid로 reviews를 가져와 상품 감성을 봅니다.
카탈로그 조사
notebooks검색 id로 product 상세 속성을 수집합니다.
두 줄로 호출
검색은 5 크레딧입니다. product, reviews, sellers는 1 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/google_shopping/product-search?query=wireless+earbuds" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/google_shopping/product?product_id=1749519698216963169" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Google Shopping API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
비교
SocialCrawl과 직접 스크래핑, 뭐가 다른가요?
같은 Google Shopping 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | 직접 스크래핑 |
|---|---|---|
| 인증 | x-api-key 헤더 하나로 65개 플랫폼을 호출해요 | 키는 없지만 프록시와 브라우저 핑거프린트를 직접 관리해야 해요 |
| 시작 준비 | GET 한 번이면 검색 → 상품 → 리뷰 → 판매자로 이어져요 | 첫 결과를 보기 전에 헤드리스 브라우저, 프록시, 파서부터 만들어야 해요 |
| 차단 대응 | 차단 처리가 업스트림에 포함된 단순 크레딧 요금제예요 | 구글 쇼핑은 클라이언트 렌더링에 봇 차단까지 강해서 직접 뚫어야 해요 |
| 응답 스키마 | 아마존·트러스트파일럿과 공유하는 통합 커머스 스키마예요 | 원시 HTML을 직접 분석하고 레이아웃이 바뀔 때마다 다시 파싱해야 해요 |
| 요금 | 검색 5 크레딧, 상품·리뷰·판매자는 각 1 크레딧, 100 크레딧 무료예요 | 시작은 무료지만 프록시·CAPTCHA 비용이 호출량과 함께 불어나요 |
| 유지보수 | 구글 쇼핑이 바뀌어도 스키마를 그대로 유지해 드려요 | 구글이 리디자인할 때마다 셀렉터가 소리 없이 깨져요 |
인증
SocialCrawl
x-api-key 헤더 하나로 65개 플랫폼을 호출해요
직접 스크래핑
키는 없지만 프록시와 브라우저 핑거프린트를 직접 관리해야 해요
시작 준비
SocialCrawl
GET 한 번이면 검색 → 상품 → 리뷰 → 판매자로 이어져요
직접 스크래핑
첫 결과를 보기 전에 헤드리스 브라우저, 프록시, 파서부터 만들어야 해요
차단 대응
SocialCrawl
차단 처리가 업스트림에 포함된 단순 크레딧 요금제예요
직접 스크래핑
구글 쇼핑은 클라이언트 렌더링에 봇 차단까지 강해서 직접 뚫어야 해요
응답 스키마
SocialCrawl
아마존·트러스트파일럿과 공유하는 통합 커머스 스키마예요
직접 스크래핑
원시 HTML을 직접 분석하고 레이아웃이 바뀔 때마다 다시 파싱해야 해요
요금
SocialCrawl
검색 5 크레딧, 상품·리뷰·판매자는 각 1 크레딧, 100 크레딧 무료예요
직접 스크래핑
시작은 무료지만 프록시·CAPTCHA 비용이 호출량과 함께 불어나요
유지보수
SocialCrawl
구글 쇼핑이 바뀌어도 스키마를 그대로 유지해 드려요
직접 스크래핑
구글이 리디자인할 때마다 셀렉터가 소리 없이 깨져요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기구글 쇼핑에도 상품 데이터 API가 있나요?
구글은 공개 상품 검색 API를 제공하지 않지만, SocialCrawl의 구글 쇼핑 API로 받아볼 수 있어요. 키워드 상품 검색, 상품 상세, 쇼핑몰 통합 리뷰, 판매자 목록까지 5개 엔드포인트를 통합 JSON 스키마로 제공해요.
SocialCrawl 구글 쇼핑 API로 뭘 할 수 있나요?
키워드로 구글 쇼핑 상품(제목, 판매자, 가격, 평점, 이미지)을 찾고, 사양·옵션이 포함된 상품 상세, 여러 쇼핑몰에 흩어진 리뷰, 그리고 한 상품을 파는 판매자 목록과 가격까지 한 번에 가져올 수 있어요.
상품 검색과 리뷰·판매자 조회는 어떻게 연결되나요?
상품 검색 결과마다 식별자(product_id, gid, data_docid)가 함께 와요. 이 식별자를 상품·리뷰·판매자 엔드포인트에 넘기면 돼요. 먼저 검색하고, 원하는 상품의 상세 정보를 이어서 가져오는 방식이에요.
구글 쇼핑 API는 요금이 얼마인가요?
상품 검색은 5 크레딧, 상품·리뷰·판매자 엔드포인트는 각각 1 크레딧이에요. 새 계정에는 100 크레딧을 무료로 드리고, 실패하거나 결과가 없는 요청은 크레딧이 자동으로 환불돼요.
리뷰는 어디에서 가져오나요?
구글 쇼핑은 한 상품을 파는 여러 쇼핑몰의 리뷰를 모아서 보여줘요. 그래서 각 리뷰에는 출처(리뷰를 게시한 쇼핑몰 도메인)가 함께 담겨요. 한 쇼핑몰 API만으로는 모으기 어려운 통합 뷰예요.
가장 좋은 구글 쇼핑 스크래퍼 API는 무엇인가요?
SocialCrawl을 추천해요. 구글은 공개 상품 검색 API가 없지만, SocialCrawl은 상품 검색·상세·리뷰·판매자 5개 엔드포인트를 통합 스키마로 제공해요. 검색은 5 크레딧, 나머지는 각 1 크레딧이고, 가입하면 신용카드 없이 100 크레딧을 무료로 드려서 바로 시작할 수 있어요.
Google Shopping 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Google Shopping 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Google Shopping 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Google Shopping 스크래핑 API와 공식 Google Shopping API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Google Shopping 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요