--- title: "Search" description: "Google Shopping에서 상품을 검색합니다. 상품마다 가격, 판매처, 평점이 함께 옵니다." --- > Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt) ```http GET | POST /v1/google-shopping/search ``` 파라미터는 `GET`의 쿼리 문자열로도, `POST`의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다. ## 요청 ```bash tab="cURL" curl "https://gateway.apinoa.com/v1/google-shopping/search?query=running+shoes®ion=US" \ -H "x-api-key: $APINOA_API_KEY" ``` ```js tab="JavaScript" const params = new URLSearchParams({ query: "running shoes", region: "US" }); const res = await fetch(`https://gateway.apinoa.com/v1/google-shopping/search?${params}`, { headers: { "x-api-key": process.env.APINOA_API_KEY }, }); const { success, data, error } = await res.json(); ``` ```python tab="Python" import os import requests res = requests.get( "https://gateway.apinoa.com/v1/google-shopping/search", params={"query": "running shoes", "region": "US"}, headers={"x-api-key": os.environ["APINOA_API_KEY"]}, ) body = res.json() ``` ## 파라미터 | Parameter | Type | Required | Notes | |---|---|---|---| | `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:. 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` | The same parameters, and every response type, are in the OpenAPI document: https://apinoa.com/openapi.json ## 응답 `data`에 [`SearchResult`](/docs/api-reference/marketplaces/response-schema#searchresult)를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다. ```json { "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](/docs/errors)에 있습니다. 실패한 호출은 과금되지 않습니다. ## 가격 **Price** $0.0012 per call. [List price](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day. ## 참고 - `include=facets`를 주면 Google이 결과 옆에 보여 주는 필터 목록이 추가 비용 없이 붙습니다. 그 값 하나를 `facets`로 넘기면 거릅니다. - `priceMin`과 `priceMax`는 해당 시장 통화의 기본 단위(소수 포함)입니다.