코스트코 코리아 API
costco.co.kr 데이터를 구조화된 JSON으로 받으세요. 상품을 검색하면 원화 가격, 평점, 리뷰 수, 재고 상태를 받고, 설명, 이미지, 사양이 담긴 상품 상세를 조회하고, 가장 가까운 매장을 찾을 수 있습니다. 모든 조회는 "country": "kr"을 넣은 POST 한 번입니다.
가입 시 50크레딧 무료. 코스트코 코리아 검색 50회에 충분합니다. 카드 불필요.
{ "data": { "country": "kr", "query": "우유", "corrected_query": null, "total_results": 51, "page": 1, "page_size": 24, "total_pages": 3, "count": 24, "results": [ { "position": 1, "product_id": "664672", "title": "화과방 우유앙빵 35g x 15입 x 2", "english_title": "Hwakwabang Milk Manju 35g x 15ct x 2", "url": "https://www.costco.co.kr/Gift-Set-Special/Gift-Set-Special-Offers/Hwakwabang-Milk-Manju-35g-x-15ct-x-2/p/664672", "image": "https://www.costco.co.kr/medias/sys_master/images/hd4/h61/243881309470750.jpg", "price": 30990, "price_hidden": false, "price_formatted": "30,990원", "currency": "KRW", "rating": 4.8, "reviews_count": 16, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 }, { "position": 2, "product_id": "693917", "title": "매일두유 고단백 플레인 190ml x 24", "english_title": "Maeil Soymilk Protein Plain 190ml x 24", "url": "https://www.costco.co.kr/Foods/Beverages/Soy-MilkMilk/Maeil-Soymilk-Protein-Plain-190ml-x-24/p/693917", "image": "https://www.costco.co.kr/medias/sys_master/images/h5d/he6/469903677784094.jpg", "price": 17990, "price_hidden": false, "price_formatted": "17,990원", "currency": "KRW", "rating": 5, "reviews_count": 5, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 } ] }, "response_time": 2414}코스트코 코리아를 대상으로 실제 엔드포인트를 실시간 호출합니다. 무료 실행 2회, 이후에는 내 키로 실행하세요.
Scavio 코스트코 코리아 API란 무엇인가요?
Scavio 코스트코 코리아 API는 costco.co.kr 데이터를 구조화된 JSON으로 반환하는 REST API입니다. 코스트코에는 공개 API가 없습니다. Scavio의 한국용 POST 엔드포인트 3개는 원화 가격이 포함된 상품 검색, 상품 상세, 매장 찾기를 제공하며, 호출당 1크레딧에 API 키 하나로 사용할 수 있습니다.
- 3
- 코스트코 코리아용 엔드포인트, 운영 중
- 1
- 호출당 크레딧
- 24
- 기본 페이지당 상품 수
코스트코 코리아에서 받을 수 있는 데이터
상품별 가격, 평점, 재고 상태, 전체 상품 상세, 가까운 매장.
원화 가격이 포함된 검색
POST /api/v1/costco/searchcostco.co.kr을 검색하면 페이지당 24개 결과를 받으며, 각 결과에 원화(KRW) 가격, 평점, 리뷰 수, 재고 상태가 들어 있습니다. 응답에는 실제 전체 건수도 포함됩니다. 2026년 11월 2일 "우유" 검색은 51건, 3페이지였습니다.
상품 상세
POST /api/v1/costco/product검색에서 받은 product_id로 상품을 조회합니다. 가격, 설명, 전체 이미지, 브랜드와 용량 같은 사양, 상품이 속한 카테고리를 반환합니다.
매장 찾기
POST /api/v1/costco/warehouses좌표 기준으로 가장 가까운 코스트코 코리아 매장을 warehouse_id, 주소, 영업시간과 함께 찾습니다.
코스트코 코리아 API의 엔드포인트 3개
모든 경로는 POST이고 JSON을 반환하며 같은 API 키를 사용합니다. 본문에 "country": "kr"을 추가하세요. 성공한 호출당 1크레딧입니다.
| 엔드포인트 | 반환 데이터 | 크레딧 |
|---|---|---|
검색/api/v1/costco/search | costco.co.kr 상품을 키워드로 검색: product_id, 상품명과 영문 상품명, 원화 가격과 표시 가격, 평점, 리뷰 수, 재고 상태, 회원 전용 여부. 정렬과 페이지 이동 지원 | 1 |
상품 상세/api/v1/costco/product | 한국 검색 결과의 product_id로 상품 1개 조회: 가격, 설명, 전체 이미지, 사양, 카테고리 | 1 |
매장 찾기/api/v1/costco/warehouses | 위도와 경도에서 가장 가까운 코스트코 매장 | 1 |
가입 시 받는 50크레딧으로 50회 호출할 수 있습니다. 매장별 가격과 재고, 주유소, 쿠폰북, 특가, 클리어런스, 리뷰, 카테고리, 자동 완성은 미국과 캐나다 코스트코 전용입니다. 요금제 보기
코드에서 코스트코 코리아 검색하기
"우유"를 검색하면 상품별 원화 가격, 평점, 리뷰 수, 재고 상태를 받습니다. 오른쪽 응답은 실제 필드 이름 그대로인 실제 캡처입니다.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 코스트코 코리아 검색 - 1크레딧, 페이지당 24개 상품
res = client.costco.search("우유", country="kr")
for item in res["data"]["results"]:
print(item["product_id"], item["price"], item["currency"], item["title"])
# 한국 검색 결과의 product_id로 상품 상세 조회 - 1크레딧
detail = client.costco.product(item_id="664672", country="kr"){
"data": {
"country": "kr",
"query": "우유",
"corrected_query": null,
"total_results": 51,
"page": 1,
"page_size": 24,
"total_pages": 3,
"count": 24,
"results": [
{
"position": 1,
"product_id": "664672",
"title": "화과방 우유앙빵 35g x 15입 x 2",
"english_title": "Hwakwabang Milk Manju 35g x 15ct x 2",
"url": "https://www.costco.co.kr/Gift-Set-Special/Gift-Set-Special-Offers/Hwakwabang-Milk-Manju-35g-x-15ct-x-2/p/664672",
"image": "https://www.costco.co.kr/medias/sys_master/images/hd4/h61/243881309470750.jpg",
"price": 30990,
"price_hidden": false,
"price_formatted": "30,990원",
"currency": "KRW",
"rating": 4.8,
"reviews_count": 16,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
},
{
"position": 2,
"product_id": "693917",
"title": "매일두유 고단백 플레인 190ml x 24",
"english_title": "Maeil Soymilk Protein Plain 190ml x 24",
"url": "https://www.costco.co.kr/Foods/Beverages/Soy-MilkMilk/Maeil-Soymilk-Protein-Plain-190ml-x-24/p/693917",
"image": "https://www.costco.co.kr/medias/sys_master/images/h5d/he6/469903677784094.jpg",
"price": 17990,
"price_hidden": false,
"price_formatted": "17,990원",
"currency": "KRW",
"rating": 5,
"reviews_count": 5,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
}
]
},
"response_time": 2414
}다른 코스트코 데이터 API 대신 Scavio를 쓰는 이유
코스트코에는 공개 API가 없고, 서드파티 API는 대부분 웹사이트 카탈로그에서 멈춥니다.
코스트코, 그리고 카탈로그만 다루는 코스트코 API
- 코스트코는 상품, 가격, 재고 데이터를 위한 공개 API를 제공하지 않습니다
- 서드파티 코스트코 API(OpenWebNinja, Unwrangle, Piloterr, Bright Data, Oxylabs)는 검색, 상품 상세, 리뷰를 다룹니다
- 여러 매장의 진열 가격, 주유소 가격, 쿠폰북, 클리어런스 코드를 문서화한 곳은 없습니다
Scavio 코스트코 API
- costco.co.kr의 검색, 상품 상세, 매장 찾기를 원화 가격과 함께 제공
- 같은 키로 costco.com과 costco.ca 전체 지원: 매장 가격, 재고, 주유소, 쿠폰북, 클리어런스
- 미국과 캐나다 외에 한국을 포함한 코스트코 6개 국가에서 검색과 상품 상세 지원
- 키 하나, 가입 시 50크레딧 무료, 모든 Scavio 플랫폼과 같은 JSON 형식
서드파티 지원 범위는 2026년 10월 기준 각 업체의 공개 문서를 바탕으로 합니다. Scavio는 공개 데이터만 반환합니다.
개발자들이 만드는 것
코스트코 코리아 가격 모니터링
costco.co.kr에서 관심 있는 상품을 정기적으로 조회하고 원화 가격을 저장해 모든 가격 변동을 잡아냅니다. 2026년 11월 2일 기준 화과방 우유앙빵 35g x 15입 x 2의 가격은 30,990원이었습니다.
search상품 카탈로그 구축
코스트코 코리아가 게시한 그대로 상품별 설명, 전체 이미지, 사양, 카테고리를 받아 카탈로그를 만들거나 보강합니다. 검색 결과의 english_title로 영문 상품명도 함께 받을 수 있습니다.
search + product검색 노출 순위 추적
모든 결과에 순위, 평점, 리뷰 수가 들어 있습니다. 검색어별로 내 상품이 몇 번째에 노출되는지, 가격순이나 평점순 정렬에서 어떻게 바뀌는지 측정합니다.
search여러 쇼핑 채널 비교
같은 API 키로 코스트코 코리아와 Google Shopping 등 Scavio의 다른 플랫폼을 함께 조회하고, 형식이 비슷한 JSON 응답으로 비교합니다.
search + Google Shopping API매장 지도
사용자 좌표를 기준으로 가장 가까운 코스트코 매장을 주소, 영업시간과 함께 보여 줍니다.
warehouses쇼핑 에이전트
AI 에이전트에 코스트코 코리아를 도구로 연결합니다. 상품 가격, 브랜드별 선택지, 가장 가까운 매장을 에이전트가 직접 조회합니다.
MCP + REST코스트코 코리아 데이터를 JSON으로 받는 방법
- 1
API 키 받기
Scavio 계정을 만들고 대시보드에서 키를 복사합니다. 가입하면 50크레딧을 무료로 받으며, 카드와 코스트코 회원권은 필요하지 않습니다.
- 2
코스트코 코리아 검색
Authorization: Bearer 헤더와 함께 {"query": "우유", "country": "kr"}를 https://api.scavio.dev/api/v1/costco/search로 보냅니다. 정렬은 sort_by, 페이지 이동은 page로 지정합니다.
- 3
상품 상세 조회
결과의 product_id를 item_id로, "country": "kr"과 함께 /api/v1/costco/product에 보냅니다. 모든 응답은 data 안에 내용이 들어 있고, credits_used와 credits_remaining이 함께 옵니다.
코스트코 코리아 API 자주 묻는 질문
코스트코 코리아에 공개 API가 있나요?
+
없습니다. 코스트코는 상품, 가격, 재고 데이터를 위한 공개 API를 제공하지 않습니다. Scavio의 코스트코 API는 코스트코 데이터를 구조화된 JSON으로 반환하는 POST 엔드포인트로 이 공백을 채우며, costco.co.kr에서는 검색, 상품 상세, 매장 찾기를 사용할 수 있습니다.
코스트코 코리아에서 사용할 수 있는 엔드포인트는 무엇인가요?
+
검색(/api/v1/costco/search), 상품 상세(/api/v1/costco/product), 매장 찾기(/api/v1/costco/warehouses)이며, "country": "kr"을 함께 보냅니다. 매장별 가격, 매장별 재고, 주유소 가격, 쿠폰북, 특가, 클리어런스 검색, 리뷰, 카테고리, 자동 완성은 한국에서 제공되지 않으며 미국과 캐나다 코스트코에서만 동작합니다(쿠폰북은 미국 전용).
한국 검색에서는 어떤 필터를 쓸 수 있나요?
+
키워드, 정렬, 페이지 이동입니다. query, sort_by(best_match, price_low, price_high, top_rated. newest는 한국에서 사용할 수 없음), page(1-500), page_size(최대 100)를 지원합니다. warehouse_id, brands, 가격과 평점 필터, on_sale, in_stock, in_warehouse는 미국과 캐나다 전용이며, "country": "kr"과 함께 보내면 400 오류가 반환됩니다.
가격은 어떤 통화로 나오나요?
+
원화입니다. 각 결과에는 숫자인 price, 코스트코에 표시된 문자열인 price_formatted, 그리고 currency "KRW"가 들어 있습니다. 예를 들어 2026년 11월 2일 화과방 우유앙빵 35g x 15입 x 2는 30990과 "30,990원"이었습니다.
상품명을 영어로도 받을 수 있나요?
+
네. 한국 검색 결과에는 한국어 title과 함께 english_title이 들어 있습니다. 예를 들어 화과방 우유앙빵의 english_title은 "Hwakwabang Milk Manju 35g x 15ct x 2"였습니다.
코스트코 코리아 상품 id는 어떻게 얻나요?
+
"country": "kr" 검색 결과의 product_id 필드에서 얻습니다. 예: 664672. id는 국가별 사이트마다 다르기 때문에 costco.com의 id는 costco.co.kr에서 쓸 수 없습니다. 한국에서 상품 상세 엔드포인트는 호출당 item_id 하나를 받으며, 최대 20개를 받는 item_ids는 미국과 캐나다 전용입니다.
상품 상세에는 무엇이 들어 있나요?
+
상품명, URL, 대표 이미지와 전체 이미지, 원화 가격과 표시 가격, 평점, 리뷰 수, 재고 상태, 회원 전용 여부, 최대 주문 수량, 설명, 사양, 카테고리입니다.
한국의 코스트코 매장을 찾을 수 있나요?
+
네. "country": "kr"과 함께 latitude와 longitude를 /api/v1/costco/warehouses로 보내면 됩니다. zip 파라미터는 미국 우편번호 전용입니다. limit은 1-50(기본값 10)이며 호출당 1크레딧입니다.
한국에서 매장별 가격이나 재고를 받을 수 있나요?
+
아니요. 매장 가격, 매장별 재고, 검색의 warehouse_id 필터는 미국과 캐나다 코스트코 전용입니다. 한국에서는 costco.co.kr의 온라인 가격을 반환합니다.
코스트코 코리아 API 요금은 얼마인가요?
+
한국에서는 검색, 상품 상세, 매장 찾기 모두 호출당 1크레딧입니다(costco.com 검색은 2크레딧). 신규 계정은 가입 시 카드 없이 50크레딧을 무료로 받으며, 유료 요금제는 월 30달러에 7,000크레딧부터 시작합니다.
데이터는 얼마나 최신인가요?
+
모든 요청은 호출 시점에 코스트코를 실시간으로 조회하므로, 가격과 재고 상태는 그 순간 코스트코에 표시된 내용과 같습니다. 야간에 만든 사본에서 가져오는 데이터는 없습니다.
어떤 언어와 도구를 쓸 수 있나요?
+
모든 엔드포인트는 JSON 본문을 보내는 일반 HTTPS POST이므로 어떤 언어에서도 동작합니다. Scavio는 Python과 JavaScript SDK, AI 에이전트용 원격 MCP 서버(mcp.scavio.dev), n8n 커뮤니티 노드도 제공하며, 모두 같은 API 키를 씁니다.
어느 나라의 코스트코를 지원하나요?
+
미국(costco.com)과 캐나다(costco.ca)는 모든 엔드포인트를 지원합니다. 단, 쿠폰북은 미국 전용입니다. 검색, 상품 상세, 매장 찾기는 멕시코, 영국, 호주, 일본, 한국, 대만 코스트코도 지원하며, 검색은 키워드, 정렬, 페이지 이동만 가능합니다.
코스트코 코리아 데이터를 사용해도 법적으로 문제없나요?
+
Scavio는 코스트코의 공개 데이터만 반환하며 회원 계정이나 주문 내역에는 접근하지 않습니다. 코스트코 이용약관 준수를 포함해 데이터를 어떻게 사용할지는 사용자의 책임입니다. 구체적인 사용 사례는 법률 전문가와 상담하세요.