Costco

Costco 검색 API

키워드나 상품 번호로 코스트코를 검색하고 구조화된 상품 데이터를 JSON으로 받습니다: 온라인 가격과 정상가, 평점과 리뷰 수, 회원 전용 및 재고 플래그, 프로모션, 패싯. warehouse_id를 보내면 모든 결과에 해당 매장의 매장 가격, 재고 상태, 가격 코드가 추가됩니다. costco.com에서는 요청당 2크레딧, costco.ca와 해외 사이트에서는 1크레딧입니다.

POST/api/v1/costco/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

키워드 또는 코스트코 상품 번호, 1-200자.

Example: olive oil

countryenum<string>default:us

코스트코 사이트. us와 ca는 모든 파라미터를 지원하며, uk, au, mx, jp, kr, tw는 키워드, 정렬, 페이지 이동만 지원합니다.

Example: uk

us — costco.com, 미국.
ca — costco.ca, 캐나다.
uk — 영국.
au — 호주.
mx — 멕시코.
jp — 일본.
kr — 한국.
tw — 대만.

warehouse_idstring

매장 찾기 엔드포인트에서 받은 코스트코 매장 번호. 모든 결과에 해당 매장의 매장 가격, 재고 상태, 가격 코드를 추가합니다. 온라인 가격만 필요하면 생략하세요. us와 ca 전용.

Example: 1062

sort_byenum<string>default:best_match

결과 정렬 순서. best_match 이외의 정렬에서는 코스트코가 일치 범위를 넓힙니다. newest는 uk, au, mx, jp, kr, tw에서 사용할 수 없습니다.

Example: price_low

best_match — 코스트코의 관련도순.
price_low — 낮은 가격순.
price_high — 높은 가격순.
top_rated — 평균 평점 높은 순.
newest — 최신 상품순(us와 ca).

brandsarray<string>

지정한 브랜드만, 최대 20개 이름, 예: ["Kirkland Signature"]. us와 ca 전용.

Example: ["Kirkland Signature"]

min_pricenumber

최소 온라인 가격(포함), 0 이상. us와 ca 전용.

Example: 10

max_pricenumber

최대 온라인 가격(포함), 0 이상. us와 ca 전용.

Example: 50

min_ratingnumber

최소 평균 평점, 1-5. us와 ca 전용.

Example: 4

on_saleboolean

할인이 진행 중인 상품만. us와 ca 전용.

Example: true

in_stockboolean

품절 상품 숨기기. us와 ca 전용.

Example: true

in_warehouseboolean

warehouse_id 매장에서 판매 중이고 재고가 있는 상품만. warehouse_id가 필요합니다.

Example: true

pageintegerdefault:1

결과 페이지, 1부터 시작, 1-500.

Example: 2

page_sizeintegerdefault:24

페이지당 결과 수, 1-120(uk, au, mx, jp, kr, tw에서는 최대 100).

Example: 48

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# warehouse_id를 보내면 모든 행에 매장 가격과 가격 코드가 추가됩니다
results = client.costco.search("olive oil", warehouse_id="1062", page_size=5)

for item in results["data"]["results"]:
    store = item.get("warehouse") or {}
    print(item["item_number"], item["title"], item["price"], store.get("price"))

Response

"country": "us",

"query": "olive oil",

"category": null,

"redirected_to_category": null,

"corrected_query": null,

"warehouse_id": "1062",

"total_results": 106,

"page": 1,

"page_size": 5,

"total_pages": 22,

"count": 5,

"response_time": 3357

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # warehouse_id를 보내면 모든 행에 매장 가격과 가격 코드가 추가됩니다 results = client.costco.search("olive oil", warehouse_id="1062", page_size=5) for item in results["data"]["results"]: store = item.get("warehouse") or {} print(item["item_number"], item["title"], item["price"], store.get("price"))