RSSナビ REST API
RSSナビのRSSフィード検索、最新ヘッドライン検索の結果を受け取るためのRSET APIを用意しております。
RSSリーダの機能などの一つとしてお使いください。
※ご利用になりましたらご連絡ください。RSSナビの中で紹介させていただきます。
REST APIとは?
HTTP GET/POSTでのリクエストに対してXML形式で応答を返すようなAPIをREST APIと呼びます。
RSSナビには検索などの条件をGETで渡し、結果をXML形式(RSS1.0)で返すAPIがあります。 |
■RSSフィード検索
RSSナビに掲載されているRSSフィードの中から、カテゴリ、企業サイトか個人サイト、キーワードの条件にマッチしたフィードのリストを返します。
ユーザがブラウザからWebサイトを検索することなくRSSフィードを検索できるようになります。下のサンプルも参考にしてください。
| URL |
http://www.rssnavi.jp/rss/?k=srch_feed |
パラメータ (GETで指定) |
パラメータ値 |
説明 |
| c |
カテゴリID 一覧はこちら ※指定しない場合はすべてのカテゴリから検索 |
| t |
企業サイト : 1
個人サイト : 2
※指定しない場合は企業・個人サイト両方 |
| kw |
キーワード
※サイト名、サイトの説明、RSSフィードの説明にマッチするものを返します。現在は1単語のみ指定可能です。キーワードはEUCでURLエンコードしたものを指定してください。 |
| n |
結果の最大件数
※最大100件まで。指定しない場合は50件までを返します |
| 戻り値 |
RSS1.0形式で返します。並び順は新着RSS、サイトランキングの上位になります。 |
| 要素名 |
説明 |
| title |
サイトの名前およびフィードの説明です。以下のフォーマットで返します。
サイトの名前 [フィードの説明] |
| link |
RSSフィードのURLです |
| description |
サイトの説明とRSSナビでのサイト詳細ページへのリンクを返します。以下のフォーマットになります。
<p>サイトの説明</p>
<p>→<a href="[サイト詳細ページ]">サイトの詳細はこちら</a></p> |
| dc:subject |
「企業サイト」または「個人サイト」 |
| dc:publisher |
サイトの名前 |
| dc:date |
RSSナビへの掲載日付 |
【サンプル】
1.すべてのフィードから100件の結果を取得する (この結果を見る)
http://www.rssnavi.jp/rss/?k=srch_feed&n=100
2.ニュース・メディアのカテゴリの企業サイトから50件を取得する (この結果を見る)
http://www.rssnavi.jp/rss/?k=srch_feed&c=1&t=1&n=50
3.スポーツのカテゴリの個人サイトから「サッカー」というキーワードで10件取得する (この結果を見る)
http://www.rssnavi.jp/rss/?k=srch_feed&c=4&t=2&n=10&kw=%A5%B5%A5%C3%A5%AB%A1%BC
■最新ヘッドライン検索
RSSナビに掲載されているRSSフィードの記事から、カテゴリ、企業サイトか個人サイト、キーワードの条件にマッチしたヘッドラインのリストを返します。下のサンプルも参考にしてください。
| URL |
http://www.rssnavi.jp/rss/?k=srch_headline |
パラメータ (GETで指定) |
パラメータ値 |
説明 |
| c |
カテゴリID 一覧はこちら ※指定しない場合はすべてのカテゴリから検索 |
| t |
企業サイト : 1
個人サイト : 2
※指定しない場合は企業・個人サイト両方 |
| kw |
キーワード
※サイト名、サイトの説明、RSSフィードの説明にマッチするものを返します。現在は1単語のみ指定可能です。キーワードはEUCでURLエンコードしたものを指定してください。 |
| n |
結果の最大件数
※最大300件まで。指定しない場合は100件までを返します |
| 戻り値 |
RSS1.0形式で返します。並び順は最新日付、サイトランキングの上位になります。 |
| 要素名 |
説明 |
| title |
記事のタイトルおよびサイトの名前を返します。以下のフォーマットになります。
記事のタイトル 【from サイト名】 |
| link |
記事のURL(RSSナビからのリダイレクトURLです) |
| description |
ありません |
| dc:subject |
カテゴリ名(カテゴリを指定しない場合は「最新ヘッドライン」となります |
| dc:publisher |
サイトの名前 |
| dc:date |
記事の更新日 |
【サンプル】
1.すべての記事から100件の結果を取得する (この結果を見る)
http://www.rssnavi.jp/rss/?k=srch_headline&n=100
2.ニュース・メディアのカテゴリの企業サイトから50件の記事を取得する (この結果を見る)
http://www.rssnavi.jp/rss/?k=srch_headline&c=1&t=1&n=50
3.スポーツのカテゴリの個人サイトから「サッカー」というキーワードで10件の記事を取得する (この結果を見る)
http://www.rssnavi.jp/rss/?k=srch_headline&c=4&t=2&n=10&kw=%A5%B5%A5%C3%A5%AB%A1%BC
■RSSナビで使用可能なカテゴリIDの一覧
| カテゴリID |
説明 |
| 1 |
ニュース・メディア |
| 2 |
コミュニティ(掲示板など) |
| 3 |
コンピュータ・インターネット |
| 4 |
スポーツ |
| 5 |
趣味 |
| 6 |
女性 |
| 7 |
企業情報(プレスリリース・IRなど) |
| 8 |
エンターテイメント |
| 9 |
ビジネス&経済 |
| 10 |
仕事&就職 |
| 11 |
有名人 |
| 12 |
コラム |
| 13 |
ショッピング |
| 14 |
健康&医学 |
| 15 |
住まい・暮らし |
| 16 |
個人の日記など |
| 99 |
その他 |
|