Shopify
Shopify 스토어를 공통 마켓플레이스 스키마로 제공합니다. 스토어를 가로질러 검색하고, 스토어 하나의 카탈로그를 나열하고, 상품과 그 리뷰를 읽습니다.
오퍼레이션
| 오퍼레이션 | 엔드포인트 | 반환 | 가격 |
|---|---|---|---|
| Search | GET | POST /v1/shopify/search | SearchResult | $0.001 |
| Image Search | POST /v1/shopify/image-search | SearchResult | $0.001 |
| Catalog | GET | POST /v1/shopify/catalog | SearchResult | $0.001 |
| Product | GET | POST /v1/shopify/product | Product | $0.001 |
| Reviews | GET | POST /v1/shopify/reviews | ReviewPage | $0.001–$0.007 |
browse가 없습니다. 다른 마켓플레이스는 키워드 없이 카테고리를 나열할 수 있지만 Shopify는 그럴 수 없습니다.
Shopify 검색에는 query가 필수입니다. 그리고 기준으로 탐색할 카테고리 자체가 없습니다. Shopify는 하나의 분류 체계가 아니라 수백만 개의 독립 스토어이므로, 컬렉션 id는
한 스토어 안에서만 의미가 있습니다. 그래서 /v1/shopify/browse는 "이 카테고리는 품절"로 읽힐 빈 페이지를
제공하는 대신 404를 반환합니다. 한 스토어의 상품 — 전체 카탈로그나 하나의 컬렉션 — 을 나열하려면
catalog를 사용하세요.
categories도 없습니다. categories는 browse에 쓸 id를 건네주기 위해 존재하는데, browse가 없으니
그 id가 할 일이 없고, id를 만들어낼 판매자 공통 트리도 없습니다.
Shopify는 하나의 스토어가 아닙니다. 검색 결과는 여러 독립 스토어에 걸쳐 있고, catalog는 한 스토어의 상품을 나열하며,
product와 reviews는 한 스토어의 상품을 가리킵니다.
Shopify 검색은 항상 실시간입니다.
ID 형식
Shopify id는 복합 형식 — shop/handle — 입니다.
us.giesswein.com/wool-sneaker-women검색 아이템의 id가 이미 이 형식이므로, 검색 결과를 스토어 탐색 단계 없이 바로 product와 reviews로
이어 쓸 수 있습니다. 전체 상품 URL도 받습니다.
실제로 도착하는 것
검색 아이템
| 필드 | 채움률 |
|---|---|
title | ~99% |
price url | ~95% |
imageUrl seller | ~90% |
rating | ~85% |
상품
| 필드 | 채움률 |
|---|---|
title price brand | ~100% |
inStock variants seller media.images | ~98% |
options | ~60–78% |
seller는 스토어 호스트에서 도출되므로 사실상 항상 있습니다. options가 낮은 이유는 단일 변형 상품에
들어 있는 자리표시용 축을 보고하지 않고 제외하기 때문입니다.
Shopify는 이 중 brand, inStock, variants가 가장 조밀한 마켓플레이스이고, Amazon이 제공하는 상세
페이지 부가 정보는 가장 빈약합니다 — reviewSummary, reviewAspects, offers가 없습니다.
Shopify에만 해당하는 것
변형을 따로 조회할 수 없습니다. 색상은 별도의 상품이 아니라 한 상품 안의 SKU이므로
variant.productId가 없습니다 — 한 번의 호출로 이미 모든 것을 받습니다.
결과가 여러 판매자에 걸쳐 있습니다. 한 검색 결과의 두 아이템이 배송, 반품, 통화가 서로 다른 무관한 두
스토어에서 올 수 있습니다. seller가 어느 스토어인지 알려줍니다.
배송비는 결제 단계 전까지 책정되지 않으므로 delivery.cost가 없습니다. 이는 "명시되지 않음"이지 무료가 아닙니다.