赤すぐnet | APIリファレンス | リクルートWEBサービス

商品検索API

リクエストURL

http://webservice.recruit.co.jp/akasugu/item/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
code	掲載コード	商品に割り当てられた番号で検索します。(10個まで指定可能*2)	*1	(例)99999
company	販社名	販売会社名で検索します。（部分一致）（UTF-8・URLエンコーディング）	*1	(例)リクルート
brand	ブランド名	ブランド名で検索します。（部分一致）（UTF-8・URLエンコーディング）	*1	(例)リクルート
name	商品名	商品名で検索します。（部分一致）（UTF-8・URLエンコーディング）	*1	(例)トレー
large_category_cd	大カテゴリーコード	大カテゴリーで検索します。(3個まで指定可能*2)	*1	(例)2
middle_category_cd	中カテゴリーコード	中カテゴリーで検索します。(10個まで指定可能*2)	*1	(例)210
small_category_cd	小カテゴリーコード	小カテゴリーで検索します。(10個まで指定可能*2)	*1	(例)210001
age_cd	対象月齢コード	月齢で絞り込みます。(5個まで指定可能*2)	*1	(例)a01
keyword	キーワード	販社名、ブランド名、商品名、キャッチの全文検索をします。（UTF-8・URLエンコーディング）	*1	(例)お手入れ
price_min	最低価格	価格帯で絞り込みます。単位：円。		(例)2000
price_max	最高価格	価格帯で絞り込みます。単位：円。		(例)5400
order	ソート順	検索結果の並び順を指定します。		0:赤すぐnetおすすめ順(デフォルト)、1:価格安い順、2:価格高い順、3:商品名順
start	検索の開始位置	検索結果の何件目から出力するかを指定します。		初期値:1
count	1ページあたりの取得数	検索結果の最大出力データ数を指定します。		初期値：10、最小1、最大100
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xml または json または jsonp。

*1　いずれか最低1つが必要
*2 複数可のパラメータの指定方法
name=value1&name=value2&...、あるいはname=value1,value2&...

サンプルクエリ

中カテゴリーが「洋服」または「アパレル小物」で価格が5000円以下の商品を検索(結果は価格安い順)

http://webservice.recruit.co.jp/akasugu/item/v1/?key=[APIキー]&middle_category_cd=401&middle_category_cd=402&price_max=5000&order=1

※実際にご利用いただくには新規登録をした上で、取得したご自身のAPIキーをGETパラメータに加えていただく必要があります。

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.01
results_available	クエリー条件にマッチする、検索結果の全件数	251
results_returned	このＸＭＬに含まれる検索結果の件数	10
results_start	検索結果の開始位置	1
item	[複数要素]
code	掲載コード	3789
company	販社名
brand	ブランド名
name	商品名	お食事用トレー＆マット（ボックス柄）
price	価格	2500
catch_copy	キャッチコピー	テーブルと床の食べこぼしをキャッチ
desc	商品説明	お食事用トレーは、高めの縁取りで汁物もしっかりキャッチ。裏には滑り止め加工も。フロアーマットは床に座ってのお食事にもお役立ち。いずれも、汚れてもサッと拭くだけだから、お手入れも簡単。
image
pc	PC用画像URL
mobile	携帯用画像URL
large_category
code	大カテゴリーコード	2
name	大カテゴリー	ベビー＆キッズ
middle_category
code	中カテゴリーコード	210
name	中カテゴリー	授乳・お食事グッズ
small_category
code	小カテゴリーコード	210004
name	小カテゴリー	マット
urls
mobile	リンク先URL（携帯）
pc	リンク先URL(PC)
qr	リンク先URL（QRコード）画像サイズ等の変更方法はこちら

サンプルレスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<results xmlns="http://webservice.recruit.co.jp/akasugu/">
	<api_version>1.00</api_version>
	<item>
		<code>03789</code>
		<company></company>
		<brand></brand>
		<name>お食事用トレー＆マット（ボックス柄）</name>
		<price>2500</price>
		<catch_copy>テーブルと床の食べこぼしをキャッチ</catch_copy>
		<desc>お食事用トレーは、高めの縁取りで汁物もしっかりキャッチ。裏には滑り止め加工も。フロアーマットは床に座ってのお食事にもお役立ち。いずれも、汚れてもサッと拭くだけだから、お手入れも簡単。</desc>
		<image>
			<mobile>http://picture.fitter.jp/fitter/akasugu-net/...</mobile>
			<pc>http://akasugu.net/...</pc>
		</image>
		<large_category>
			<code>2</code>
			<name>ベビー＆キッズ</name>
		</large_category>
		<middle_category>
			<code>210</code>
			<name>授乳・お食事グッズ</name>
		</middle_category>
		<small_category>
			<code>210004</code>
			<name>マット</name>
		</small_category>
		<urls>
			<mobile>http://akasugu.net/...</mobile>
			<pc>http://akasugu.net/...</pc>
			<qr>http://webservice.recruit.co.jp/...</qr>
		</urls>
	</item>
	<item>
                …(アイテム数分繰り返し）…
	</item>
	<results_available>1</results_available>
	<results_returned>1</results_returned>
	<results_start>1</results_start>
</results>

大カテゴリマスタAPI

リクエストURL

http://webservice.recruit.co.jp/akasugu/large_category/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	4
results_returned	このＸＭＬに含まれる検索結果の件数	4
results_start	検索結果の開始位置	1
large_category	[複数要素]
code	大カテゴリコード	2
name	大カテゴリーテキスト	ベビー＆キッズ

中カテゴリマスタAPI

リクエストURL

http://webservice.recruit.co.jp/akasugu/middle_category/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
large_code	大カテゴリコード	複数指定可能*2		(例)2
middle_code	中カテゴリコード	複数指定可能*2		(例)211
keyword	フリーワード	文字コードはUTF8。半角スペース区切りの文字列を渡すことでAND検索になる。複数指定可能*2。		(例)ベビー
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

*2 複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
middle_category	[複数要素]
code	中カテゴリコード	211
name	中カテゴリーテキスト	おふろ・トイレグッズ
large_category
code	大カテゴリコード	2
name	大カテゴリーテキスト	ベビー&キッズ

小カテゴリマスタAPI

リクエストURL

http://webservice.recruit.co.jp/akasugu/small_category/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
large_code	大カテゴリコード	複数指定可能*2		(例)2
middle_code	中カテゴリコード	複数指定可能*2		(例)211
small_code	小カテゴリコード	複数指定可能*2		(例)211001
keyword	フリーワード	文字コードはUTF8。半角スペース区切りの文字列を渡すことでAND検索になる。複数指定可能*2。		(例)ベビー
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

*2 複数可のパラメータの指定方法
name=value1&name=value2&...または name=value1,value2,...

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
small_category	[複数要素]
code	小カテゴリコード	211001
name	小カテゴリ名	おむつ
large_category
code	大カテゴリコード	2
name	大カテゴリテキスト	ベビー&キッズ
middle_category
code	中カテゴリコード	211
name	中カテゴリテキスト	おふろ・トイレグッズ

対象月齢マスタAPI

リクエストURL

http://webservice.recruit.co.jp/akasugu/age/v1/

検索クエリ

パラメータ	項目名	説明	必須	値
key	APIキー	APIを利用するために割り当てられたキーを設定します。	○
format	レスポンス形式	レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名を指定する事により、javascript側コールバック関数の名前を指定できます。		初期値:xml。xmlまたはjsonまたはjsonp

レスポンスフィールド

フィールド	説明	例
results
api_version	APIのバージョン	1.00
results_available	クエリー条件にマッチする、検索結果の全件数	7
results_returned	このＸＭＬに含まれる検索結果の件数	7
results_start	検索結果の開始位置	1
age	[複数要素]
code	対象月齢コード	a04
name	対象月齢テキスト	０～3ヶ月

エラー時のレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns="http://webservice.recruit.co.jp/akasugu/">
  <api_version>1.00</api_version>
  <error>
    <message>keyは必須パラメーターです</message>
  </error>
</results>

エラーの際でも、HTTPレスポンスステータスは常に "200 OK" が返ります。なので実装側では常にレスポンスXMLの内容を見てエラー判断を行ってください。

Flashからの利用方法

Flash Action Script 2.0にて本APIを利用するには1フレーム目に下記の記述を追加する必要があります:

System.security.loadPolicyFile("http://webservice.recruit.co.jp/akasugu/crossdomain.xml");

このように crossdomain.xml を指定する事で、ご自身のサイト上にある Flash SWF ファイルから、本APIを利用することが可能になります。

・ドコイク？

・ケイコとマナブ&資格と仕事

・ケイコとマナブ通信講座

・web R25

・eruca.[エルーカ]

・リクルート進学ネット

・エイビーロード

・エイビーロード航空券

・ホットペッパー

・ホットペッパーBeauty

・カーセンサーnet

・タウンマーケット

・赤すぐnet

・赤すぐ内祝い

・eyeco[アイコ]

商品検索API

リクエストURL

検索クエリ

サンプルクエリ

レスポンスフィールド

サンプルレスポンス

大カテゴリマスタAPI

リクエストURL

検索クエリ

レスポンスフィールド

中カテゴリマスタAPI

リクエストURL

検索クエリ

レスポンスフィールド

小カテゴリマスタAPI

リクエストURL

検索クエリ

レスポンスフィールド

対象月齢マスタAPI

リクエストURL

検索クエリ

レスポンスフィールド

エラー時のレスポンス

Flashからの利用方法