zerosp.blog > Web Service > 2005/12/11 17:24 >

[BWS] キーワード検索

ビッターズ Webサービス(BWS)の商品検索についてです。AmazonのWebサービスと比べると若干検索条件についてのパラメータが多くなっています。

ビッダーズへの検索リクエスト方法

AmazonではWebサービスへのリクエスト方法がRESTとSOAPが用意されていましたが、ビッダーズではRESTのみとなります。REST on XSLTももちろん準備されています。

http://xml.bidders.co.jp/bep/xml?以下パラメータ

keyword検索語句。URIエンコードが必要
charsetKeywordをURIエンコード形式の指定。省略するとShift_JISとなる
(Shift_JIS、EUC-JP、UTF-8)
enc取得するXMLデータの文字コード指定。省略するとUTF-8となる
(Shift_JIS、EUC-JP、UTF-8)
categ_id検索する商品カテゴリ
at出品区分の指定。省略時は全ての中からの検索となる。
NO(オークション)、PA(複数オークション)、FL(即決オークション)、FP(ショッピング)、GB(共同購入)
tfBWSのVersion指定。xml_lite6が最新となる。
ipp取得商品数
pageページ番号
xslREST on XSLTを使う場合はxslの指定をする
user_idアフィリエイトID(アフィリエイトリンクするのに必要)
link_idリンクID(アフィリエイトリンクするのに必要)

個人的に使用しているのはこんな感じです。他に使用しそうなものを挙げるとすれば。

xsl_no_cacheREST on XSLTの開発支援用。xsl_no_cache=YでXSLのキャッシュをオフにする。通常は指定しないこと
chigh価格の上限を指定する。
clow価格の下限を指定する。
sort検索時にSortをかけて検索。省略時はend,Aとなる。
end,A (締切が近い)、end,D (締切が遅い)
start,A (最近の出品)、start,D (古い出品)
price,A (価格が安い)、price,D (価格が高い)
num,A (入札数・販売数が少)、num,D (入札数・販売数が多)
pdeal,D(過去一週間の購入者数の多い順）
psold,D（過去一週間の販売数の多い順）
psales,D（過去一週間の売上金額の多い順）

他にも後少しあるんだけど使わないと思われるから省略。機会があればまた後日書きます。実際にパラメータ例を書いてみましょう。グルメカテゴリから松坂牛を検索。UTF-8でデータを取得する。

http://xml.bidders.co.jp/bep/xml
  ?keyword=%E3%82%B9%E3%83%86%E3%83%BC%E3%82%AD
  &enc=UTF-8
  &charset=UTF-8
  &categ_id=909
  &tf=xml_lite6
  &at=FP
  &page=1
  &ipp=10
  &user_id=0Aq5y5lfSmKVEb2NRcuJ.8G--
  &link_id=273642

Amazon WebサービスだとUTF-8でのやり取りが必須条件です。それに比べるとBWSはパラメータでShift_JIS、EUC-JP、UTF-8が選べるわけなんですが、余程のことがない限りUTF-8がいいと思います。REST on XSLTを使用する場合は必ずUTF-8を指定してください。

主な商品カテゴリID

categ_idで使用する商品ジャンルのID番号を書いておきます。

  • 本 : 212
  • コンピュータ : 7
  • 家電 : 8
  • 音楽・DVD : 2
  • キャラクターグッズ : 1
  • おもちゃ・ゲーム : 1019
  • ホビー・カルチャー : 28
  • コレクション : 6
  • チケット・金券 : 211
  • グルメ : 909
  • 美容・健康 : 921
  • 子供用品 : 10
  • アクセサリー : 27
  • ブランド : 4
  • ファッション : 3
  • レジャー・スポーツ : 5
  • 自転車・バイク : 508
  • 暮らし : 9
  • ビジネス用品 : 11
  • ペット : 931

取得できるXMLデータの構造

tf=xml_lite6を利用した際に取得できるXMLの構造です。

<?xml version="1.0" encoding="UTF-8" ?>
<ListingInfo>
  <Request>
    <Parameters>
      <!-- リクエストパラメータ -->
      <Parameter value="ステーキ" name="keyword" />
      <Parameter value="1" name="page" />
      <Parameter value="UTF-8" name="enc" />
      ===== 以下略 =====
    </Parameters>
  </Request>
  <TotalCount>247</TotalCount>
  <TotalPage>25</TotalPage>
  <CurrentPage>1</CurrentPage>
  <StartIndex>1</StartIndex>
  <EndIndex>10</EndIndex>
  <ItemInfo>
    <!-- 出品NO -->
    <ItemNo>56952102</ItemNo>
    <!-- 商品名 -->
    <ItemName>甲州名産　天然あわびステーキ（2個入）</ItemName>
    <!-- 出品者ID -->
    <ExhibitorId>3709301</ExhibitorId>
    <!-- 入札数・販売数 -->
    <BidNum>0</BidNum>
    <!-- 現在の価格 -->
    <CurrentPrice>7350円</CurrentPrice>
    <!-- 終了日 -->
    <EndDate>12/11 17:27</EndDate>
    <!-- 出品カテゴリID -->
    <CategoryId>909201202</CategoryId>
    <!-- 出品カテゴリへのパス -->
    <CategoryPath>グルメ・ドリンク&gt;グルメ&gt;魚介類&gt;貝類&gt;あわび</CategoryPath>
    <!-- 出品カテゴリへのパスID -->
    <CategoryIdPath>80&gt;909&gt;90938&gt;90920&gt;9092012&gt;909201202</CategoryIdPath>
    <!-- 残り時間 -->
    <RemainTime>36分</RemainTime>
    <!-- 商品画像URI -->
    <ImageUrl>http://bcimg1.dena.ne.jp/bc11/u3709301/m_d/sml_A0280002_m.jpg</ImageUrl>
    <!-- 出品数 -->
    <ItemNum>10000</ItemNum>
    <!-- 出品区分 -->
    <AuctionType>FP</AuctionType>
    <!-- 出品者名(法人のみ) -->
    <TradeMark>伊藤ハムアルトショップ</TradeMark>
  </ItemInfo>
  <ItemInfo>
    ===== 以下略 =====
  </ItemInfo>
</ListingInfo>

商品リンクの作成法

Webサービスでデータを取得してもアフィリエイト商品リンクは作成されません。その為自分でリンクを生成する必要があります。

http://www.bidders.co.jp/aff/アフィリエイトID/リンクID/WS/pitem_GKアイテムNO

といった感じになります。例えば「クイーンアリス」のカマンベールチーズケーキ の場合は、

http://www.bidders.co.jp/aff/0Aq5y5lfSmKVEb2NRcuJ.8G--/273642/WS/pitem_GK56952053

こちらがWebサービス用の商品リンクとなります。

アフィリエイトIDの取得

ビッダーズのアフィリエイトIDの取得は次のバナーよりどうぞ。

現金化できるビッダーズアフィリエイトプログラム

Webサービスを使用するときに必要なuser_idとlink_idは、ビッダーズIDを作成した後にhttp://www.bidders.co.jp/dap/sv/affidこちらのページにログインしますと、暗号化したアフィリエイトID、リンクIDとして取得できます。

投稿日 2005-12-11 17:24

当サイトのコメントとトラックバックの扱いについて。

スパム対策のため認証制となっています。受け取ったコメント、トラックバックは一旦保留扱いとなり管理人が許可したものだけ表示されます。

トラックバック

トラックバックの受付は停止中です。

コメント

コメントの受付は停止中です。