楽々おまかせリンクをバージョンアップしました(楽天 API の OR 検索に対応)

drk7jp-Webサービス

19年前に書いた記事です。製品やサービスの情報は公開当時のものです。

目次(3項目)
  1. 楽天 API に OR 検索が追加された
  2. 3つの特徴語を OR 検索するように変更
  3. OR 検索のリクエスト方法

楽々おまかせリンクをバージョンアップしました(楽天 API の OR 検索に対応)のイメージ(挿絵)

結構頻繁に update されている楽天 API ですが、楽天 API をお使いのみなさま、情報を追いかけておりますでしょうか?

僕は情報を追いかけてはいたのですが、更新する時間が全然なくて、楽々おまかせリンクのメンテを放置してきました。この度、見た目は何ら変化しない地味なバージョンアップをしました。

楽天 API に OR 検索が追加された

楽天ウェブサービスセンターブログで 2007.03.22 に公開された情報なのですが

楽天市場関係のAPIへの機能追加

以下のAPIで、「OR検索」機能、「除外キーワード」機能を追加をしました。

  • 楽天商品検索API
  • 楽天書籍検索API
  • 楽天CD検索API
  • 楽天DVD検索API
  • 楽天カタログ検索API

「OR検索」では、複数キーワードが設定された場合に、AND検索・OR検索のいずれかが選択可能となりました。また、検索結果から除外したいキーワードを「除外キーワード」として指定することで、これまで以上にデベロッパーのニーズに沿った検索が可能となりました。

この OR 検索の実装が、非常に意味がある機能なのです。楽天 API が登場したての頃に、OR 検索がどうしても欲しいとメールを出したことがあるのですが、ついに実現されました。

3つの特徴語を OR 検索するように変更

楽々おまかせリンクのアルゴリズム説明のところにも記載されていますが、

特徴語を用いて楽天ウェブサービスにリクエストを投げて商品情報を取得します。検索がヒットしない場合は、ランキング情報を代替情報として用います。

現時点で楽天ウェブサービスがキーワードの OR 条件をサポートしていないため、1つの単語のみで検索をしています。※OR 検索が実装されれば精度が飛躍的に上がるとおもう・・・

の部分を変更しました。同時に3つの特徴語を OR 検索するようにしました。これによって、飛躍的に精度向上を図ることができました。

sort オプションも指定可能なので、random あたりが検索結果的におもしろい結果になるような気がします。もっとも random を指定しても毎回ランダムになるわけではなく、楽天 API 側でキャッシュされているっぽいので、ある一定期間は同じ結果しか返ってこないっぽいですが。

OR 検索のリクエスト方法

あ、ちなみに OR 検索のリクエスト方法はドキュメントに何も書かれていませんが、keyword フィールドに半角スペースでキーワードをつなげてリクエストすれば OK のようです。OR とかを連結文字列に使う必要はないみたいです。キーワードの順序による優先順位はないみたいです。

どちらの例も、keyword を半角スペース(URL 上は %20)でつなぎ、orFlag=1 を付けてリクエストしています。

以上、バージョンアップのお知らせでした。