Search
Google Shopping에서 상품을 검색합니다. 상품마다 가격, 판매처, 평점이 함께 옵니다.
GET | POST /v1/google-shopping/search파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
요청
curl "https://gateway.apinoa.com/v1/google-shopping/search?query=running+shoes®ion=US" \
-H "x-api-key: $APINOA_API_KEY"파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
cursor | string | Next page: pass the previous result's cursor alone. | |
facets | string | object list | One value from a result's facets (include=facets), e.g. facets=Brand:<value>. Google applies one at a time. | |
include | string list | facets — the filter rail Google shows beside the results, on the same page (no extra request). | |
priceMax | number ≥ 0 | Highest price, in the market's currency (decimal major units). | |
priceMin | number ≥ 0 | Lowest price, in the market's currency (decimal major units). | |
query | string | Keywords to search for. | |
region | enum | The market, ISO 3166-1 alpha-2: US (default), GB, CA, AU. Sets the shops, prices and currency. US GB CA AU |
같은 파라미터와 모든 응답 타입은 OpenAPI 문서에도 있습니다.
응답
data에 SearchResult를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
{
"success": true,
"data": {
"marketplace": "google-shopping",
"query": "running shoes",
"page": {"index": 1, "size": 54},
"items": [
{
"marketplace": "google-shopping",
"id": "14699928440903523478",
"url": "https://www.google.com/search?ibp=oshop&q=Hoka+Men%27s+Clifton+11&prds=catalogid%3A5939486839279040471%2Cgpcid%3A14699928440903523478%2CheadlineOfferDocid%3A905…",
"title": "Hoka Men's Clifton 11",
"price": {"currency": "USD", "amount": 154.95},
"brand": "Hoka One One",
"seller": {"name": "Zappos.com", "logoUrl": "data:image/png;base64,iVBORw0KGgoAAAANSU…"},
"rating": {"average": 4.484, "count": 412},
"delivery": {"estimate": "Free delivery by Mon", "free": true},
"returnsPolicy": "Free 365-day returns",
"badges": [],
"promotions": [],
"attributes": [],
"groupId": "14699928440903523478",
"imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcRqYH_zOknkUmPHPQooSsPMYiYGJMv-jev2oHa3IYWYR3S1ZdTQiAb3gLS_dNid6BzrdE1cSbjGZFbQVF2Nkj2ST_R5sfE4Tw",
"ext": {
"summary": "Hoka Men's Clifton 11. Current Price: $154.95. Zappos.com & more. Free delivery by Mon. Free 365-day returns. Rated 4.5 out of 5. 412 reviews.",
"moreStores": true,
"shelf": "Beginner Running Shoes",
"catalogId": "5939486839279040471",
"productId": "13107188378090301883",
"offerId": "9057001329748764354",
"imageId": "8494207511608046187"
},
"offers": [
{
"seller": {
"name": "Peter Glenn Ski & Sports",
"logoUrl": "https://encrypted-tbn2.gstatic.com/favicon-tbn?q=tbn%3AANd9GcTgj6MTV2jVPsWTKNdSwoPkVupNia0bUqnfBm8PYegVt-ywkuVH1n9-VCekAnK6c1rBK6Eho-3SEcUhcTEOMxTwKsE_qF3XMchpt…"
},
"price": {"currency": "USD", "amount": 155},
"delivery": {"estimate": "Free delivery by Tue", "free": true},
"ext": {"offerId": "18164253511807076099", "shelf": "All products"}
}
]
},
{
"marketplace": "google-shopping",
"id": "1522057692120988320",
"url": "https://www.google.com/search?ibp=oshop&q=New+Balance+Women%27s+Fresh+Foam+X+Kaiha+Road+V2+Running+Shoes&prds=catalogid%3A2224207068186773069%2Cgpcid%3A15220576…",
"title": "New Balance Women's Fresh Foam X Kaiha Road V2 Running Shoes",
"price": {"currency": "USD", "amount": 104.99},
"brand": "New Balance",
"seller": {"name": "New Balance", "logoUrl": "data:image/png;base64,iVBORw0KGgoAAAANSU…"},
"rating": {"average": 5, "count": 166},
"returnsPolicy": "45-day returns",
"badges": [],
"promotions": [],
"attributes": [],
"groupId": "1522057692120988320",
"imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSSyE2K1PfUS8yxgpTwvT2vlaiCaO84uGQNRSOkkjF_LCLn3s7bRKN1RMRFX2rwek5QYVUaeWIIL4W6zE7k1A266nu7dx6K",
"ext": {
"summary": "New Balance Women's Fresh Foam X Kaiha Road V2 Running Shoes. Current Price: $104.99. New Balance & more. 45-day returns. Rated 5.0 out of 5. 166 reviews.",
"moreStores": true,
"shelf": "Beginner Running Shoes",
"catalogId": "2224207068186773069",
"productId": "16229217600571913203",
"offerId": "8468470629989173210",
"imageId": "1190089453230405951"
}
}
],
"cursor": "tRlUbjVXzLQ2mckO_0hUg_oRXAX71LylzGzTA4ov5NQm-NnRYdL9Cydv_yTsWQvUY7ouiehwkp5AzTrHVcRpPcxjhMZBDfWSR6cMUeo1EiZf7Lnj_fUyC3sfVIdge_nN-YWBk_4YkMM"
}
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_CURSOR | 이 오퍼레이션이 돌려준 cursor가 아닙니다. cursor 없이 처음부터 다시 호출하세요. |
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 429 | MARKETPLACE_SATURATED | 동시 호출이 너무 많습니다. Retry-After 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | UPSTREAM_ERROR | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | SERVICE_UNAVAILABLE | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.0012. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.
참고
include=facets를 주면 Google이 결과 옆에 보여 주는 필터 목록이 추가 비용 없이 붙습니다. 그 값 하나를facets로 넘기면 거릅니다.priceMin과priceMax는 해당 시장 통화의 기본 단위(소수 포함)입니다.