退会申請
web R25Webサービスリファレンス


ref

記事検索 API

記事の一覧を取得できます。

リクエストURL
ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code 記事コード 記事:毎のコード。複数指定でOR検索可能*1 (例) 90000462
article_type 記事タイプコード 記事タイプ毎のコード。記事タイプマスタ API参照。複数指定でOR検索可能*1 (例) 05
category カテゴリーコード カテゴリー毎のコード。カテゴリマスタ API参照。複数指定でOR検索可能*1 (例) 01,04
tag タグ タグ。web R25サイトでは、キーワードと呼ばれています。複数指定でAND検索可能*1 (例) ブログ,web
theme テーマコード テーマ毎のコード。テーママスタ API参照。複数指定でOR検索可能*1 (例) 98000118
pub_date 掲載開始日コード 掲載開始日のコードで絞り込めます。掲載開始日マスタ API参照。複数指定でOR検索可能*1 (例) 20101013
keyword フリーワード 文字コードはUTF8。半角スペース区切りの文字列を渡すことでAND検索になる。複数指定可能*1。
別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。
フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。		 例: ネット
keyword_or フリーワード(OR検索) 文字コードはUTF8。半角スペース区切りの文字列 (最大5単語まで) を渡すことでOR検索になる。上記フリーワード (keyword) 指定がある場合、こちらは無視される。複数指定可能*1。
別途クエリ項目 kwic=1 を指定する事で Keyword In Context 機能も利用可能 (詳細はこちらを参照)。
フリーワードを指定して、かつ並び順 order に何も指定しない場合、検索結果は「フリーワードマッチ順」でソートされます。		 例: ネット ブログ
kiwc KWICレスポンス設定 クエリ項目「フリーワード」を利用の際、追加でこの kwic に値 1 を指定する事で API レスポンスに KWIC コンテンツを追加させる事ができます (詳細はこちらを参照) 。 例:1
order ソート順 1:新着順(デフォルト)、2:古い順
※キーワードサーチ時はデフォルトキーワードマッチ順となります
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
  • *1：複数可のパラメータの指定方法
    name=value1&name=value2&...または name=value1,value2,...
    個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
ページトップへ

サンプルクエリ

記事一覧を取得

http://webservice.recruit.co.jp/r25/article/v1?type=full&tag=%E3%83%96%E3%83%AD%E3%82%B0&key=[APIキー]

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

ページトップへ

レスポンスフィールド

フィールド 説明 例
results
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 7
results_returned このＸＭＬに含まれる検索結果の件数 7
results_start 検索結果の開始位置 1
article 記事 [複数要素]
code 記事コード 10001120
headline ヘッドライン 第11回 彼女の心をつかむ旅行術が知りたい！
sub_headline サブヘッドライン 殻を破るなら旅に出ろ！　のホント
snippet 記事の一部（記事本文の最初の約100文字程度) このところ右を向いても左を向いても電子書籍の話題だらけ。自分で買った書籍をスキャンして自分で電子化...
thumb サムネイル画像URL
article_type 記事タイプ
code 記事タイプコード 01
name 記事タイプ名 不思議レポート
category カテゴリー
code カテゴリーコード 07
name カテゴリー名 スポーツ・レジャー
theme テーマ
code テーマコード 98000118
name テーマ名 殻を破るなら旅に出ろ！　のホント
category カテゴリー
code カテゴリーコード 07
name カテゴリー名 スポーツ・レジャー
pub_date 掲載開始日(YYYYMMDD) 20091218
tag タグ[複数項目] ビル
related_link 関連リンク[複数項目]
headline 関連リンクのヘッドライン 総選挙、ネット界が1位!?
url 関連リンクへのURL http://r25.yahoo.co.jp/fushigi/..
mobile_flag モバイル掲載あり 1
section セクション。[複数項目] 文章とそれに付随する、タイトル、画像を含みます。
title タイトル 遠くにいくときは....
image 画像[複数項目]
title タイトル 遠くに行っても...
caption 外観写真キャプション これまでの...
l 画像(大)URL
s 画像(小)URL
urls
pc 記事PC用URL
mobile 記事モバイル用URL
qr 記事QR用URL
ページトップへ

ref

カテゴリマスタ API

カテゴリの一覧を取得できます。

リクエストURL
ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
  • *1：複数可のパラメータの指定方法
    name=value1&name=value2&...または name=value1,value2,...
    個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
ページトップへ

サンプルクエリ

カテゴリー一覧を取得

http://webservice.recruit.co.jp/r25/category/v1?key=[APIキー]

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

ページトップへ

レスポンスフィールド

フィールド 説明 例
results
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 7
results_returned このＸＭＬに含まれる検索結果の件数 7
results_start 検索結果の開始位置 1
category カテゴリー [複数要素]
code カテゴリーコード 01
name カテゴリー名 ライフ・マネー
ページトップへ

ref

テーママスタ API

テーママスタの一覧を取得できます。

リクエストURL
ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code テーマコード テーマ毎のコード。複数指定可能*1 (例) 00000612
category カテゴリコード カテゴリ毎のコード。複数指定可能*1 (例) 01,04
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
  • *1：複数可のパラメータの指定方法
    name=value1&name=value2&...または name=value1,value2,...
    個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
ページトップへ

サンプルクエリ

カテゴリー一覧を取得

http://webservice.recruit.co.jp/r25/theme/v1?key=[APIキー]

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

ページトップへ

レスポンスフィールド

フィールド 説明 例
results
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 7
results_returned このＸＭＬに含まれる検索結果の件数 7
results_start 検索結果の開始位置 1
theme テーマ [複数要素]
code テーマコード 00000612
name テーマ名 「夜カジ族」のススメ
category カテゴリー
code カテゴリーコード 01
name カテゴリー名 ライフ・マネー
ページトップへ

ref

記事タイプ API

記事タイプの一覧を取得できます。

リクエストURL
ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
  • *1：複数可のパラメータの指定方法
    name=value1&name=value2&...または name=value1,value2,...
    個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
ページトップへ

サンプルクエリ

記事タイプ一覧を取得

http://webservice.recruit.co.jp/r25/article_type/v1?key=[APIキー]

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

ページトップへ

レスポンスフィールド

フィールド 説明 例
results
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 7
results_returned このＸＭＬに含まれる検索結果の件数 7
results_start 検索結果の開始位置 1
article_type 記事タイプ [複数要素]
code 記事タイプコード 01
name 記事タイプ名 不思議レポート
ページトップへ

ref

掲載開始日マスタ API

掲載開始日の一覧を取得できます。

リクエストURL
ページトップへ

検索クエリ

パラメータ 項目名 説明 必須 値
key APIキー APIを利用するために割り当てられたキーを設定します。 ○
code 掲載開始日コード 掲載開始日毎のコード。(YYYYMMDD) 複数指定可能*1 (例) 20071126
from 開始指定 掲載開始日が指定日以降で絞り込む。 (例) 20071126
to 終了指定 掲載開始日が指定日以前で絞り込む。 (例) 20071126
start 検索の開始位置 検索結果の何件目から出力するかを指定します。 初期値:1
count 1ページあたりの取得数 検索結果の最大出力データ数を指定します。 初期値：10、最小1、最大100
format レスポンス形式 レスポンスをXMLかJSONかJSONPかを指定します。JSONPの場合、さらにパラメータ callback=コールバック関数名 を指定する事により、javascript側コールバック関数の名前を指定できます。 初期値:xml。xmlまたはjsonまたはjsonp
  • *1：複数可のパラメータの指定方法
    name=value1&name=value2&...または name=value1,value2,...
    個数の上限が指定されてる場合は、その数を超えたパラメータは無視されます。
ページトップへ

サンプルクエリ

記事タイプ一覧を取得

http://webservice.recruit.co.jp/r25/pub_date/v1?key=[APIキー]

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

ページトップへ

レスポンスフィールド

フィールド 説明 例
results
api_version APIのバージョン 1.00
results_available クエリー条件にマッチする、検索結果の全件数 7
results_returned このＸＭＬに含まれる検索結果の件数 7
results_start 検索結果の開始位置 1
pub_date 掲載開始日 [複数要素] 20071126
ページトップへ


ref

エラー時のレスポンス

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

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

ページトップへ

ref

Flashからの利用方法

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

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

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

ページトップへ