COMMERCE_SERP に site ebay を指定すると、検索結果の商品をストアの順に受け取ります。このストアの商品ページは COMMERCE_PRODUCT では読み取りません。完了した検索 1 件につき 0.5 クレジットです。
検索
GET /v1/async/task/{id} をポーリングするか Webhook で受け取ります。非同期タスクを参照してください。
パラメータ
site: 必須。ebayです。query: 必須。検索語で、1-500 文字です。limit: 任意の整数、1-40。デフォルトは 20 です。country: 任意。デフォルトはストアの国のUSです。ほかの国は422 REGION_UNSUPPORTEDで拒否されます。
include は省略してください。include: {} でも、クレジットを確保する前に payload.include の 422 VALIDATION_ERROR を返します。
レスポンス例
結果フィールド
site、query、countryはリクエストの値です。returnedCountはproductsの件数です。- 各商品は
rank、productId、title、urlを含みます。productIdは eBay の商品番号です。rankはストアのデフォルトの並び順で、ストアが広告と表示した商品は除きます。 price、rating、reviewCount、imageUrlは、検索結果の画面に表示されている場合に含みます。priceは商品ごとのcurrency(ISO 4217)の数値で、容量ごとに価格が異なる場合は最も低い価格です。ratingは 5 点満点です。 999+ のように省略表示されたレビュー数は含みません。- 検索ごとに、ストアの検索結果の 1 ページ目から商品を取得します。
エラーと課金
- 商品が 1 つもない検索は、失敗したタスクとして終了します。
- 課金は完了した検索だけで、1 件につき 0.5 クレジットです。