검색
쇼피파이 검색 — 받는 파라미터와 돌아오는 값.
GET|POST /v1/shopify/searchPrice $0.001 per call. List price; the rate steps down above 1,000 calls a day.
| Parameter | Type | Required | Notes |
|---|---|---|---|
query | string | yes | Keywords to search for. Required: Shopify search always needs a keyword, which is also why Shopify has no keyword-less browse. |
categoryId | string | Narrow to one category, by the marketplace's own id. Opaque and per-marketplace; take it from Product.category[].id or from a result's facets. | |
condition | enum | Item condition: new or used. refurbished is refused by name rather than folded into used — the catalog sells new and secondhand, and those are different claims. new used | |
cursor | string | Opaque; comes from the previous response and carries the page index. Shopify pages by cursor rather than by number — this is the only paging knob, and page is refused by name. | |
inStock | boolean | enum | Only listings the marketplace reports as purchasable now. | |
priceMax | number ≥ 0 | Highest price to return, in decimal major units. | |
priceMin | number ≥ 0 | Lowest price to return, in decimal major units. | |
ratingMin | number 0–5 | Lowest average star rating to return, on the marketplace's own 0-5 scale. | |
region | string | Buyer country as ISO 3166-1 alpha-2; sets availability, shipping and price. |
curl "https://gateway.apinoa.com/v1/shopify/search?query=wool+socks&priceMin=20&priceMax=60&ratingMin=4&inStock=true" \
-H "x-api-key: YOUR_API_KEY"쇼피파이는 페이지 번호가 아니라 커서로 넘깁니다. 앞선 응답의 cursor를 그대로 되돌려 보내세요.
page는 거부됩니다.
pageSize는 없습니다 — 무엇을 요청하든 카탈로그가 응답을 50개로 제한합니다.
sort는 없습니다. 쇼피파이 검색은 정렬을 전혀 제공하지 않습니다. 여기서 정렬이 없는 유일한
마켓플레이스입니다.
brands는 없습니다.
검색에는 currency가 없습니다 — 표시 통화는 region을 따릅니다. 반면 product는 currency를
받습니다. 스토어프론트가 하나의 통화로 고정될 수 있기 때문입니다.
condition=refurbished는 used로 바꾸지 않고 거부합니다. 카탈로그가 파는 것은 new와
secondhand이고, 둘은 서로 다른 주장입니다.