メインコンテンツへスキップ
AliExpress(aliexpress.com)の商品を非同期タスク API で検索します。COMMERCE_SERP に site aliexpress を指定すると、検索結果の商品をストアの順に受け取ります。このストアの商品ページは COMMERCE_PRODUCT では読み取りません。完了した検索 1 件につき 0.5 クレジットです。

検索

タスクを送信したあと、GET /v1/async/task/{id} をポーリングするか Webhook で受け取ります。非同期タスクを参照してください。

パラメータ

  • site: 必須。aliexpress です。
  • 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 はストア独自の商品 ID です。rank はストアのデフォルトの並び順で、ストアが広告と表示した商品は除きます。
  • price、rating、imageUrl は、検索結果の画面に表示されている場合に含みます。price は商品ごとの currency(ISO 4217)の数値で、容量ごとに価格が異なる場合は最も低い価格です。 AliExpress の価格は、ログインしていない米国の購入者に表示されるセール価格です。
  • rating は 5 点満点です。 AliExpress は評価件数なしで星だけを表示するため、reviewCount はありません。
  • 検索ごとに、ストアの検索結果の 1 ページ目から商品を取得します。

エラーと課金

  • 商品が 1 つもない検索は、失敗したタスクとして終了します。
  • 課金は完了した検索だけで、1 件につき 0.5 クレジットです。

関連