スペック検索情報取得API

スペック検索情報取得APIとは、coneco.netでの商品検索のように、 スペックにて商品を検索したい場合に、そのスペックの一覧と検索用IDを取得するAPIです。

このAPIにて取得した、検索したいスペックのIDを商品検索APIに「specId=100」の様に条件として指定することで、 条件に合うスペックで絞り込みをした商品の情報が取得できるようになります。

使用方法

スペック検索情報取得APIにて取得したスペック情報から、商品検索APIにて絞り込むまでの簡単な流れは以下の通りです。

• 検索したい小カテゴリを指定して、スペック検索用情報の一覧を取得する。
• 取得した情報の一覧から、商品検索APIにて絞り込みを行いたいスペックのIDを取得する。
• 検索したいスペックIDを商品検索APIのパラメータとして指定します。

具体的に「デスクトップパソコン(Windows)」（カテゴリID「1011010」）で、スペックにて絞り込み検索を行う場合の例は以下の通りです。

• スペック検索項目取得APIにカテゴリID「1011010」を指定しスペック情報を取得する。下記、サンプルXMLを参照。
• 得られた情報を元に、「CPUタイプ」を「Intel　Core 2 Duo」で絞り込みたい場合は、
  検索結果「<Spec id="1106986">Intel　Core Duo</Spec>」から、該当するスペックID「1106986」を抜き出します。
• 上で取得したスペックIDを、商品検索APIに検索条件としてリクエストを行い、絞り込まれた情報を取得します。
  ex.http://api.coneco.net/cws/v1/SearchProducts?apikey=****&categoryId=1011010&specId=1106986

リクエストURL

入力パラメータ

カテゴリ検索APIでの指定可能なパラメータの一覧です。

項目名	フィールド名	型	必須	デフォルト	備考
APIキー	apikey	String	○	-	各ユーザごとのAPIキー
カテゴリID	categoryId	integer	○	-	level=3のカテゴリのみ指定可能。
コールバック関数	callback	String			JSONP形式の場合のみ使用する、コールバック関数。

出力パラメータ

カテゴリ検索API使用時の結果一覧です。

項目名	フィールド名	型	備考
共通ヘッダ
APIバージョン	APIVersion	String	APIのバージョンを表します
入力条件	Condition		入力条件より得られる情報を表します。
入力カテゴリ	Category		検索条件にカテゴリIDを指定した場合、そのカテゴリ自体の情報を表します。
カテゴリID	Id	integer	カテゴリIDを表します。
カテゴリ名	Name	String	カテゴリ名称を表します。
入力パラメータ	comId等	String	商品検索API呼び出し時の入力パラメータを表示します。
状態	Status	String	APIの問合せ結果をメッセージで返します。
サービス固有パラメータ
カテゴリ	Category		Level=3のカテゴリを表します。
カテゴリID	Id	integer	カテゴリIDを表します。
カテゴリ名	Name	String	カテゴリ名称を表します。
カテゴリURL	Url	String	カテゴリごとのURLを表します。
スペック検索情報	SearchSpec		スペック検索項目ごとの検索値を表します。
スペック項目ID	Id	String	スペック検索項目のIDを表します。
スペック項目名	Title	String	スペック検索項目の名称を表します。
スペック情報	Specifications		個別のスペック検索項目ごとの検索値、名称を表します。
スペック	Spec	integer	id(属性)：商品検索APIにて、指定するスペック検索用IDを表します。
		String	値：商品のスペック情報を表します。

サンプル出力

検索条件：カテゴリID「1011010」（Level=3、「デスクトップパソコン(Windows)」）に属する、スペック検索項目一覧を取得する。

http://api.coneco.net/cws/v1/SearchCategories?apikey=******&categoryId=1011010

<SpecificationInfos xmlns="http://api.coneco.net/cws/v1/">
<Header>
 <APIVersion>1.8.0</APIVersion>
 <Count/>
 <Condition>
  <categoryId>1011010</categoryId>
 </Condition>
 <Status>Success</Status>
</Header>
<Item>
 <Category>
  <Level>3</Level>
  <Id>1011010</Id>
  <Name>デスクトップパソコン(Windows)</Name>
  <Url>http://www.coneco.net/idx/01011010.html</Url>
 </Category>
  <SearchSpec>
   <Id>Maker</Id>
   <Title>メーカー</Title>
   <Specifications>
    <Spec id="0">すべて</Spec>
    <Spec id="5778179">ACER/エイサー</Spec>
    <Spec id="5778380">ASUS/ASUSTeK</Spec>
    <Spec id="5778453">BenQ/ベンキュー</Spec>
    <Spec id="5778701">DELL/デル</Spec>
    <Spec id="5778784">eMachines/イーマシーンズ</Spec>
    <Spec id="5778828">Everex/エバレックス</Spec>
    <Spec id="5778883">Gateway/ゲートウェイ</Spec>
    <Spec id="5778966">HP/ヒューレットパッカード</Spec>
    <Spec id="5779215">MSI</Spec>
    <Spec id="5779248">NEC/日本電気</Spec>
    <Spec id="5779613">Shuttle/シャトル</Spec>
    <Spec id="5779688">SOTEC/ONKYO</Spec>
    <Spec id="5780617">エプソン/EPSON</Spec>
    <Spec id="5780890">オンキョー/ONKYO</Spec>
    <Spec id="5781964">シャープ/SHARP</Spec>
    <Spec id="5782563">ソニー/SONY</Spec>
    <Spec id="5782470">ソーテック/SOTEC</Spec>
    <Spec id="5783019">トライジェムジャパン</Spec>
    <Spec id="5784152">マウスコンピュータ/MCJ</Spec>
    <Spec id="5784623">レノボ/Lenovo(旧IBM)</Spec>
    <Spec id="5785571">富士通/FUJITSU</Spec>
    <Spec id="5785429">日立/HITACHI</Spec>  
   </Specifications>
  </SearchSpec>
  <SearchSpec>
   <Id>Spec1</Id>
   <Title>CPUタイプ</Title>
   <Specifications>
    <Spec id="0">すべて</Spec>
    <Spec id="1395">AMD　Athlon</Spec>
    <Spec id="2697">AMD　Athlon 64</Spec>
    <Spec id="55442">AMD　Athlon 64 FX</Spec>
    <Spec id="55441">AMD　Athlon 64 X2</Spec>
    <Spec id="1396">AMD　Athlon XP</Spec>
    <Spec id="1397">AMD　Duron</Spec>
    <Spec id="3682059">AMD　Phenom X3</Spec>
    <Spec id="4379269">AMD　Phenom X4</Spec>
    <Spec id="3493">AMD　Sempron</Spec>
    <Spec id="4379270">AMD　Turion 64 X2</Spec>
    <Spec id="4379271">Intel　Atom</Spec>
    <Spec id="1400">Intel　Celeron</Spec>
    <Spec id="3376">Intel　Celeron D</Spec>
    <Spec id="1106987">Intel　Celeron M</Spec>
    <Spec id="1106986">Intel　Core 2 Duo</Spec>
    <Spec id="3682060">Intel　Core 2 Quad</Spec>
    <Spec id="1106985">Intel　Core Duo</Spec>
    <Spec id="4774546">Intel　Core i7</Spec>
    <Spec id="55440">Intel　Pentium D</Spec>
    <Spec id="2567096">Intel　Pentium Dual Core</Spec>
    <Spec id="1106988">Intel　Pentium M</Spec>
    <Spec id="1399">Intel　Pentium4</Spec>
    <Spec id="1398">Intel　PentiumIII</Spec>
    <Spec id="2334">Intel　Xeon</Spec>  
   </Specifications>
  </SearchSpec>
  <SearchSpec>
   <Id>Spec2</Id>
   <Title>ドライブ</Title>
   <Specifications>
    <Spec id="0">すべて</Spec>
    <Spec id="801">CD-ROM</Spec>
    <Spec id="803">CD-RW</Spec>
    <Spec id="804">DVD/CD-RW</Spec>
    <Spec id="806">DVD-ROM</Spec>
    <Spec id="807">DVD-ROM・CD-RW</Spec>
    <Spec id="808">DVD-RAM・CD-RW</Spec>
    <Spec id="809">DVD-RAM/R</Spec>
    <Spec id="810">DVD-RW</Spec>
    <Spec id="812">DVD-ROM・DVD-RW</Spec>
    <Spec id="813">DVD+RW</Spec>
    <Spec id="1955">DVD±RW・DVD-ROM</Spec>
    <Spec id="1956">DVD±RW</Spec>
    <Spec id="2681">DVDマルチ</Spec>
    <Spec id="2682">DVDマルチ・DVD-ROM</Spec>
    <Spec id="2683">DVDスーパーマルチ</Spec>
    <Spec id="2886">DVDスーパーマルチ (DVD+R DL)・DVD-ROM</Spec>
    <Spec id="3431">DVD±R/RW (DVD+R DL)</Spec>
    <Spec id="3432">DVDスーパーマルチ (DVD+R DL)</Spec>
    <Spec id="1106989">DVDスーパーマルチ (DVD±R DL)</Spec>
    <Spec id="1106990">Blu-ray　(スーパーマルチ対応)</Spec>  
   </Specifications>
  </SearchSpec>
  <SearchSpec>
   <Id>Spec3</Id>
   <Title>CPUクロック</Title>
   <Specifications>
    <Spec id="0">すべて</Spec>
    <Spec id="24">1.6GHｚ未満</Spec>
    <Spec id="628">1.6GHz以上 2.0GHz未満</Spec>
    <Spec id="1403">2.0GHz以上 2.4GHz未満</Spec>
    <Spec id="1405">2.4GHz以上 2.8GHz未満</Spec>
    <Spec id="2345">2.8GHz以上 3.0GHz未満</Spec>
    <Spec id="2346">3.0GHz以上</Spec>
    <Spec id="3982">3.2GHz以上</Spec>
    <Spec id="3983">3.4GHz以上</Spec>
    <Spec id="3984">3.6GHz以上</Spec>  
   </Specifications>
  </SearchSpec>
  <SearchSpec>
   <Id>Spec4</Id>
   <Title>メモリ</Title>
   <Specifications>
    <Spec id="0">すべて</Spec>
    <Spec id="827">64MB 以上</Spec>
    <Spec id="828">128MB 以上</Spec>
    <Spec id="829">256MB 以上</Spec>
    <Spec id="830">512MB 以上</Spec>
    <Spec id="2461">1GB 以上</Spec>
    <Spec id="4379272">2GB 以上</Spec>
    <Spec id="4379273">3GB 以上</Spec>
    <Spec id="4379274">4GB 以上</Spec>  
   </Specifications>
  </SearchSpec>
  <SearchSpec>
   <Id>Spec5</Id>
   <Title>モニタ</Title>
   <Specifications>
    <Spec id="0">すべて</Spec>
    <Spec id="802">なし</Spec>
    <Spec id="817">15インチ未満</Spec>
    <Spec id="820">15インチ以上 17インチ未満</Spec>
    <Spec id="823">17インチ以上 19インチ未満</Spec>
    <Spec id="826">19インチ以上 21インチ未満</Spec>
    <Spec id="4717">21インチ以上 23インチ未満</Spec>
    <Spec id="4718">23インチ以上 25インチ未満</Spec>
    <Spec id="4379275">25インチ以上 27インチ未満</Spec>
    <Spec id="4379276">27インチ以上</Spec>
    </Specifications>
  </SearchSpec>
</Item>
</SpecificationInfos>

coneco.net Web Servicesとは？

conecoのもつ製品情報、価格情報などのデータを開発者や、サイト製作者の皆様に開放し、新しいサービスやサイトを作成するためのWebサービスです。
詳細…

ドキュメント

• APIリファレンス
  • カテゴリ検索API
  • 商品検索API
  • レビュー検索API
  • スペック検索情報取得API
  • 共通エラーメッセージ
• 利用規約
• クレジット表示

• API ライブラリ&
  サンプルアプリケーション

API活用事例

• “事例一覧は
  こちらから >>”:/instance

APIキー取得

• APIキーの取得は
  こちらから >>

お知らせ

• カテゴリ別ランキングのリリース＆レビュー検索APIに商品情報を付加しました。(version1.9.0リリース）
• スペック検索情報取得APIをリリースしました。(version1.8.0リリース)
• 商品検索APIに、フリーワード検索機能を追加しました。（version1.7.4リリース）

もっと読む

コンテスト

• coneco.net Web Services コンテスト
• コンテスト結果発表

Syndicate

Articles RSS Feed

関連リンク

• coneco.net
• conecoポイントパーク
• 通販.ne.jp
• かわろ.net
• travel.jp
• 開発者blog
• 採用情報
• お問い合わせ