Product
Google Shopping에서 상품 페이지를 가져옵니다. 상세 정보, 사양, 판매처가 들어 있습니다.
GET | POST /v1/google-shopping/product파라미터는 GET의 쿼리 문자열로도, POST의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.
요청
curl "https://gateway.apinoa.com/v1/google-shopping/product?id=14699928440903523478®ion=US" \
-H "x-api-key: $APINOA_API_KEY"파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
id | string | The product, as a search item's id carries it. | |
include | string | offers · offers:5 · offers:all — every merchant selling the product, 10 per request after the 3 the page shows. Depth counts requests and each is charged; all walks to the end, capped at 20. | |
region | enum | The market, ISO 3166-1 alpha-2: US (default), GB, CA, AU. Sets the shops, prices and currency. US GB CA AU | |
url | string | A Google Shopping product link instead of id (the url a search item carries). |
같은 파라미터와 모든 응답 타입은 OpenAPI 문서에도 있습니다.
응답
data에 Product를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.
{
"success": true,
"data": {
"marketplace": "google-shopping",
"id": "14699928440903523478",
"url": "https://www.google.com/search?ibp=oshop&q=Hoka+Men%27s+Clifton+11&prds…",
"title": "Hoka Men's Clifton 11",
"price": {"currency": "USD", "amount": 154.95},
"brand": "Hoka One One",
"rating": {
"average": 4.72,
"count": 445,
"distribution": {"1": 3, "2": 1, "3": 4, "4": 11, "5": 84},
"starCounts": {"1": 11, "2": 2, "3": 14, "4": 46, "5": 372}
},
"seller": {
"id": "15872",
"name": "Zappos.com",
"logoUrl": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.zappos.co…",
"rating": {"average": 4.8}
},
"badges": [],
"promotions": [],
"attributes": [{"name": "Size", "value": "Size 5, Size 5½, Size 6, Size 6½, Size 7, Size 7½, Size 8, Size 8½, Si…"}],
"groupId": "14699928440903523478",
"description": "The Men's HOKA Clifton 11 Running Shoe is a lightweight shoe for runni…",
"features": [],
"media": {"images": ["https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSwvRhrsajonYuP…"], "videos": []},
"category": [],
"options": [
{
"id": "Color",
"name": "Color",
"values": [
{
"id": "EigiBWNvbG9yKh9hbnRpcXVlIG9saXZlIC8gcml2ZXIgcm9jayBncmV5",
"name": "Antique Olive / River Rock Grey",
"imageUrl": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSTx7SmeSRrNlMr…"
}
]
}
],
"variants": [],
"offers": [
{
"seller": {
"id": "15872",
"name": "Zappos.com",
"logoUrl": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.zappos.co…",
"rating": {"average": 4.8}
},
"price": {"currency": "USD", "amount": 154.95},
"inStock": true,
"status": "In stock online",
"delivery": {"estimate": "Free delivery between Sat - Mon", "free": true},
"ext": {
"title": "HOKA Clifton 11 Men's Running Shoes Galactic Grey/Stellar Grey : 10 D…",
"returns": "Free 365-day returns",
"offerId": "6449949928584705062",
"badges": ["Best price"],
"url": "https://www.zappos.com/product/10047344/color/1107224?utm_medium=fpa&u…"
}
}
],
"reviewSummary": "Users praise these shoes for their exceptional comfort, lightweight fe…",
"reviewAspects": [{"name": "Comfort", "positive": 130, "negative": 7}],
"boxContents": [],
"reviews": [
{
"id": "PR_3P_f5ad9bac86f8a072818655448a2d2a25",
"author": "Joshua W",
"authorAvatarUrl": "https://lh3.googleusercontent.com/shsm/AGYqVK3f_a0qsNdewufUaN9jNMjhBA2…",
"rating": 3,
"title": "Looking for some help",
"body": "The shoes feel great.. the very light and comfortable under the foot….…",
"images": [],
"syndicatedFrom": "ewavedemo.com",
"ext": {"dateText": "2 months ago"}
}
],
"ext": {
"aspectDetails": [
{
"name": "Comfort",
"positive": "Comfortable",
"negative": "Uncomfortable",
"summary": "Users find the shoes to be very comfortable, with many experiencing a…"
}
],
"reviewImageCount": 39,
"insights": [
{
"topic": "Comfort (Midsole, Cushioning)",
"cards": [
{
"kind": "review",
"source": "Tom's Guide",
"title": "I ran 35 miles in the Hoka Clifton 11 and it’s a comfortable daily tra…",
"url": "https://www.tomsguide.com/wellness/running/hoka-clifton-11-review",
"favicon": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.tomsguide…",
"pros": ["Comfortable upper"],
"more": "4 more pros and cons",
"dateText": "2mo"
}
]
}
],
"discussions": [
{
"title": "Have you upgraded to the new HOKA Clifton 11 yet? We've been testing o…",
"url": "https://www.facebook.com/RoadRunnerSports/posts/have-you-upgraded-to-t…",
"source": "Facebook",
"favicon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.facebook.…",
"dateText": "3 months ago",
"answers": [
{
"text": "A supercritical ProGlide+ midsole brings it in line with its daily tra…",
"url": "https://www.facebook.com/RoadRunnerSports/posts/have-you-upgraded-to-t…"
}
]
}
],
"relatedProducts": [
{
"id": "11647404279960666288",
"url": "https://www.google.com/search?ibp=oshop&q=HOKA+Men%27s+Rincon+4&prds=c…",
"title": "HOKA Men's Rincon 4",
"price": {"currency": "USD", "amount": 80},
"listPrice": {"currency": "USD", "amount": 125},
"seller": "JD Sports",
"rating": {"average": 4.4},
"reviewCountText": "1k+",
"badges": ["36% OFF"],
"imageUrl": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSGvxJsiQ4WzXyw…",
"shelf": "More options"
}
],
"typicalPrice": {"min": {"currency": "USD", "amount": 155}, "max": {"currency": "USD", "amount": 165}},
"typicalPriceText": "Typically $155 to $165",
"priceHistory": [
{
"seller": "Zappos.com",
"points": [{"date": "2026-08-13", "price": {"currency": "USD", "amount": 155}}]
}
]
}
}
}에러
| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | INVALID_PARAMS | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | UNAUTHORIZED | x-api-key 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | INSUFFICIENT_BALANCE | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 404 | PRODUCT_NOT_FOUND | Google Shopping에 그 상품이 없습니다. 메시지에 그 id가 나옵니다. |
| 429 | MARKETPLACE_SATURATED | 동시 호출이 너무 많습니다. Retry-After 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | UPSTREAM_ERROR | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | SERVICE_UNAVAILABLE | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |
모든 코드는 Errors에 있습니다. 실패한 호출은 과금되지 않습니다.
가격
가격 호출당 $0.0012, 추가 호출마다 $0.0012 — 최대 20번 더, 합계 최대 $0.0252. 정가 기준이며, 하루 1,000회를 넘으면 단가가 내려갑니다.
참고
- 검색 결과 항목의
id나url을 넘깁니다. include=offers를 주면 상품을 파는 모든 판매처가 붙습니다. 페이지에 보이는 3곳 다음부터 요청 하나에 10곳씩이며 요청마다 1단위입니다(offers:5는 5번,offers:all은 최대 20번).