이베이
정규화된 스키마로 제공되는 이베이 검색·카테고리 탐색·이미지 검색·상품 — 받는 파라미터, 상태 필터, 그리고 어떤 필드가 실제로 도착하는지.
다섯 개의 오퍼레이션, 미국 마켓플레이스, USD.
| 엔드포인트 | 가격 | |
|---|---|---|
| search | GET|POST /v1/ebay/search | $0.001 |
| browse | GET|POST /v1/ebay/browse | $0.001 |
| categories | GET|POST /v1/ebay/categories | $0.001, 3단계 아래는 +$0.001 |
| image-search | POST /v1/ebay/image-search | $0.002 |
| product | GET|POST /v1/ebay/product | $0.001 |
reviews는 없습니다. 이베이의 피드백은 리스팅이 아니라 판매자의 것입니다. 그것을 reviews로
제공하면 "이 상품은 얼마나 좋은가"를 묻는 호출자에게 "이 판매자는 얼마나 좋은가"를 답하는 셈이 됩니다.
여기 있는 마켓플레이스 가운데 이베이가 가장 넓은 필터 집합을 받습니다. 이베이의 조건 파라미터는 질의에 종속된 id가 아니라 이미 알고 있는 값을 받기 때문입니다.
실제로 도착하는 것
검색 아이템
| 필드 | 채움률 |
|---|---|
title url | 100% |
price imageUrl delivery | ~95% |
delivery.estimate badges | ~90% |
condition | ~85% |
상품
| 필드 | 채움률 |
|---|---|
title | 100% |
price seller.name delivery | ~95% |
attributes delivery.estimate returnsPolicy badges | ~90% |
condition media.images | ~65% |
brand | ~50% |
미리 대비해야 할 것은 brand입니다. 이베이 리스팅은 판매자가 직접 작성하며, 제목에 브랜드가 적혀
있어도 절반은 브랜드 필드를 채우지 않습니다. 브랜드 커버리지가 필요하다면 월마트와 쇼피파이가 훨씬
촘촘합니다.
condition은 정반대입니다. 여기 있는 마켓플레이스 중 리스팅의 상태를 믿을 만하게 밝히는 곳은
이베이뿐인데, 재고 대부분이 새 상품이 아니기 때문입니다.
필터, 그리고 이베이가 하지 않는 한 가지
facets=Type:Complete Set은 모든 이베이 aspect로 결과를 좁히며 추가 비용이 없습니다.
이베이가 돌려주지 않는 것은 무엇을 쓸 수 있는지 나열한 패싯 레일입니다. 이베이 응답에는 facets
레일이 없지만, facets=Name:Value는 그래도 적용됩니다.
aspect의 이름과 값은 이베이 검색 UI에서 가져오거나, 앞선 검색이 돌려준 아이템의 attributes에서
가져오세요.
이베이에만 해당하는 것
배송비가 문장이 아니라 숫자입니다. 이베이가 금액을 밝히면 delivery.cost에 그 숫자가 담기므로,
배송비 $19.95인 $48짜리 상품과 무료배송인 $55짜리 상품을 비교할 수 있습니다.
경매와 즉시구매 리스팅이 함께 있습니다. sort=ending_soonest는 경매 종료 순으로 정렬합니다. 경매
가격은 빠르게 바뀔 수 있으니, 종료가 임박한 경매를 추적한다면 fresh=1을 넘기세요.
카테고리가 이름 없이 id만 올 수 있습니다. 이베이는 말단 카테고리를 번호로만 밝히는 경우가 많습니다.
스키마는 카테고리 단계에 id, name, 또는 둘 다를 허용합니다. 거짓이 될 이름을 지어내지 않기
위해서입니다.