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

検索

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

パラメータ

  • site: 必須。qoo10 です。
  • query: 検索語で、1-500 文字です。url を送らない場合は必須です。
  • url: 検索の代わりに読み取る Qoo10 のショップページです(例: https://www.qoo10.jp/shop/LG-BEAUTY)。アドレスのクエリ文字列は取り除きます。query と url のどちらか一方だけを送ります。
  • limit: 任意の整数、1-40。デフォルトは 20 です。url を送る場合は 1-200 で、デフォルトは 200 です。
  • country: 任意。デフォルトはストアの国の JP です。ほかの国は 422 REGION_UNSUPPORTED で拒否されます。
受け付けるペイロードフィールドは上記のみです。include は省略してください。include: {} でも、クレジットを確保する前に payload.include の 422 VALIDATION_ERROR を返します。

レスポンス例

結果フィールド

  • site、query、country はリクエストの値です。returnedCount は products の件数です。 url を送ったタスクは、query の代わりに読み取ったショップページの url を返します。
  • 各商品は rank、productId、title、url を含みます。productId はストア独自の商品 ID です。rank はストアのデフォルトの並び順で、ストアが広告と表示した商品は除きます。
  • price、rating、reviewCount、imageUrl、brand は、検索結果の画面に表示されている場合に含みます。price は商品ごとの currency(ISO 4217)の数値で、容量ごとに価格が異なる場合は最も低い価格です。
  • rating は 5 点満点です。 999+ のように省略表示されたレビュー数は含みません。
  • 検索ごとに、ストアの検索結果の 1 ページ目から商品を取得します。
  • Qoo10 のショップページには、販売者がショップの区画に並べた商品が表示されます。products はそれらをページの順に limit 件まで、同じ商品は 1 回だけ含みます。price は各カードに表示された価格で、カードがショップのクーポンを適用して表示している場合はその価格です。

商品ページ

パラメータ

  • url: 必須。Qoo10 の商品ページで、2,048 文字以内です。形式は qoo10.jp/g/{id} です。検索結果の商品 url はそのまま渡せます。トラッキングコードなど結果に影響しないパラメータは読み取り前に取り除きます。
  • country: 任意。デフォルトはページの国の JP です。ほかの国は 422 REGION_UNSUPPORTED で拒否されます。
受け付けるペイロードフィールドは上記のみです。include は省略してください。include: {} でも、クレジットを確保する前に payload.include の 422 VALIDATION_ERROR を返します。

レスポンス例

結果フィールド

  • site、country、url、productId でページを識別します。url は読み取ったページで、productId は検索結果の ID と同じです。
  • title は常に含みます。brand、price、listPrice、currency、inStock、rating、reviewCount、images、descriptionImages は、ページに表示されている場合に含みます。
  • price は、クーポンと送料を適用する前にページが最初に表示する購入価格で、currency(ISO 4217)の値です。 listPrice はページが取り消し線で表示する通常価格で、price より高い場合だけ含みます。 inStock は在庫の有無です。
  • rating は小数第 2 位までの 5 点満点の評価です。 reviewCount はレビュー数です。
  • images は商品ギャラリーの写真を、ページの順に最大 30 枚含みます。
  • descriptionImages は商品説明の画像を、ページの順に最大 300 枚含みます。販売者が説明に入れたバナーやお知らせも含まれ、画像の中の文字は読み取りません。

エラーと課金

  • 商品が 1 つもない検索は、失敗したタスクとして終了します。
  • ストアが 404 または 410 で応答する商品ページ(削除された商品など)は PAGE_UNAVAILABLE で終了し、メッセージにストアの応答が入ります。ストアが 403、412、429、435 で読み取りを拒否した場合、タスクは待機して最大 6 分間再試行します。ほかの読み取り失敗と、それより長く続く拒否は ENGINE_NO_RESULT で終了します。
  • 課金は完了したタスクだけで、検索または商品ページ 1 件につき 0.5 クレジットです。

関連