ログイン
IDでもっと便利に[ 新規取得 ]

検索

ブログ検索

Version 1

リクエストURL

XML

http://search.yahooapis.jp/BlogSearchService/V1/blogSearch

PHPserialize

http://search.yahooapis.jp/BlogSearchService/V1/blogSearch

JSONP

http://search.yahooapis.jp/BlogSearchService/V1/blogSearch

ブログ検索Web APIは、ウェブ上に公開されているブログを検索する機能を提供します。

リクエストパラメータ

RESTリクエストの構築(GET)」および、「RESTリクエストの構築(POST)」をご参照ください。

パラメータ 説明
appid (必須) string アプリケーションID。詳細はこちらをご覧ください。
query (必須) string (UTF-8エンコードされた)検索クエリーです。このクエリーはYahoo!ブログ検索の全言語をサポートし、またメタキーワードも含みます。
type article (デフォルト) , channel 検索結果の種類:
  • articleはブログの記事の検索結果を返します。
  • channelはブログタイトルの検索結果を返します。
results integer: 150 (最大) 返却結果の数です。
start integer: 1 (デフォルト) 返却結果の先頭位置です。最終位置(start + results - 1)は、1000を超えられません。
term string: day , week, month 日付絞り込み機能(type=articleのみ有効):
  • dayは1日以内に更新された記事を返します。
  • weekは1週間以内に更新された記事を返します。
  • monthは1か月以内に更新された記事を返します。
output xml (デフォルト) , php, json レスポンス選択機能:
  • xmlはxml形式で結果を返します。
  • phpはphpserialize形式で結果を返します。
  • jsonはjsonp形式で結果を返します。
callback string jsonpで返却されるcallback関数名を指定します。

サンプルリクエストURL

http://search.yahooapis.jp/BlogSearchService/V1/blogSearch?appid=<あなたのアプリケーションID>&query=iphone&results=10

レスポンスフィールド

ブログ検索Web APIのスキーマの記述は、以下のURLをご覧ください。
http://search.yahooapis.jp/BlogSearchService/V1/articleSearchResponse.xsd

フィールド 説明
ResultSet クエリーレスポンスのすべてを含み、次の属性を持ちます。

  • totalResultsAvailable: データ内のマッチしたクエリー数です。
  • totalResultsReturned: 返却され、かつマッチしたクエリーの数です。もし有効な結果の合計が少ない場合、要求した結果の数より少ない場合があります。
  • firstResultPosition: 全検索結果の最初のポジションです。
Result 各個別レスポンスを含みます。
Id ページのIDです。
RssUrl ページのRSS URLです。
Title 記事のタイトルです。
Description 記事のサマリーです。
Url 記事のURLです。
Creator 記事の著者です。
mobileLink MobileLinkDiscoveryで指定されているURLです。
Site 記事を掲載しているブログのタイトル、URLです。
DateTime 記事の更新時間です。

サンプルレスポンス

以下は、Yahoo!検索スタッフブログという語を含む記事検索 のリクエストに対するレスポンスの例です。

エラー

ブログ検索Web APIはYahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。

利用制限

ブログ検索Web APIは、24時間中1つのアプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。

スタッフブログ

日々成長を続けるYahoo!検索。その戦略、サービスの詳細、Tipsなどを開発の現場から発信。検索に関する新しい情報や、いろいろなトピックスを公開しています。

開発者コミュニティ

Yahoo!グループに開発者のためのグループを用意しています。ほかのデベロッパーと交流し、質問やアイデアの共有にお役立てください。

法人デベロッパー専用お問い合わせ