検索

Search API は、フリーテキストクエリを指定すると Freebase データへのアクセスを提供します。詳細な検索クエリの作成方法については、検索の概要と検索クックブックをご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/freebase/v1/search

パラメータ

以下のパラメータはすべて省略可能ですが、query または filter のいずれか 1 つは指定する必要があります。

パラメータ名	値	説明
オプションパラメータ
`as_of_time`	`string`	`mql_output` クエリで使用する MQL `as_of_time` 値。
`callback`	`string`	JSONP コールバックの JS メソッド名。
`cursor`	`integer`	`cursor` パラメータと `limit` パラメータを使用すると、定義された数の結果を一度にページングできます。たとえば、10 件の結果が連続する 3 ページを表示するには、`limit=10` と `cursor=0`、次に `cursor=10` と `cursor=20` を使用します。
`domain`	`string`	この Freebase ドメイン ID を持つトピックに制限します。
`encode`	`string`	レスポンスのエンコード。このパラメータを使用すると、HTML エンコードを有効にできます。有効な値は次のとおりです。「`html`」: レスポンス内の特定の文字（タグやアンパサンドなど）を HTML エンコードを使用してエンコードします。 "`off`": レスポンスのエンコードなし。コンテンツを HTML エスケープせずに、結果をウェブページに直接出力しないでください。（デフォルト）
`exact`	`boolean`	名前とキーの完全一致のみをクエリします。
`filter`	`string`	`filter` パラメータを使用すると、クエリに適用するより複雑なルールと制約を作成できます。 `filter` 値は、次の記号をサポートするシンプルな言語です。 `all`、`any`、`should`、`not` 演算子 `type`、`domain`、`name`、`alias`、`with`、`without` オペランドグループ化と優先順位付けのための `(` と `)` の丸かっこ `filter` プロパティの使用方法については、検索クックブックをご覧ください。
`format`	`string`	JSON レスポンスの構造形式。有効な値は次のとおりです。 "`entity`": エンティティに関する基本情報。（デフォルト） "`ids`": Freebase `ids` の順序付きリスト。 "`mids`": Freebase `mids` の順序付きリスト。
`indent`	`boolean`	JSON の結果をインデントするかどうか。
`lang`	`string`	クエリを実行する言語のコード。デフォルトは「en」です。
`limit`	`integer`	返される結果の最大数。デフォルトでは、関連性の高い順に 20 件の一致が返されます（該当する一致が 20 件以上ある場合）。`limit` パラメータに別の値を指定すると、一致する数を増減できます。（例）。
`mql_output`	`string`	結果に対して実行して、より多くのデータを抽出する MQL クエリ。クエリが実行されると、一致するドキュメントの ID が `mql_output` MQL クエリに渡され、一致に関する実際のデータが取得されます。MQL の結果は、関連性スコアの降順で並べ替えられます。
`prefixed`	`boolean`	名前とエイリアスに対する接頭辞一致。
`query`	`string`	検索するクエリ用語。
`scoring`	`string`	使用する関連性スコアリングアルゴリズム。有効な値は次のとおりです。「`entity`」: Freebase と人気度エンティティランキングを使用します。（デフォルト）「`freebase`」: Freebase エンティティランキングを使用します。「`schema`」: プロパティとタイプにスキーマランキングを使用します。
`spell`	`string`	「もしかして」候補をリクエストする有効な値は次のとおりです。「`always`」: 3 文字以上のクエリのスペル候補をリクエストします。「`no_results`」: 結果が見つからなかった場合にスペル候補をリクエストします。「`no_spelling`」: スペル候補をリクエストしません。（デフォルト）
`stemmed`	`boolean`	語幹処理された名前とエイリアスに対してクエリを実行します。`prefixed` と併用することはできません。
`type`	`string`	この Freebase タイプ ID を持つトピックに制限します。
`with`	`string`	照合するフィルタルール。
`without`	`string`	照合しないフィルタルール。

リクエストの本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功した場合、レスポンスは JSON 構造になります。

{
  "status":"200 OK",
  "result":[
    {
      "mid":"/m/0b1zz",
      "name":"Nirvana",
      "notable":{"name":"Record Producer","id":"/music/producer"},
      "score":55.227268
    },{
      "mid":"/m/05b3c",
      "name":"Nirvana",
      "notable":{"name":"Belief","id":"/religion/belief"},
      "score":44.248726
    },{
      "mid":"/m/01h89tx",
      "name":"Nirvana",
      "notable":{"name":"Musical Album","id":"/music/album"},
      "score":30.371510
    },{
      "mid":"/m/01rn9fm",
      "name":"Nirvana",
      "notable":{"name":"Musical Group","id":"/music/musical_group"},
      "score":30.092449
    },{
      "mid":"/m/02_6qh",
      "name":"Nirvana",
      "notable":{"name":"Film","id":"/film/film"},
      "score":29.003593
    },{
      "mid":"/m/01rkx5",
      "name":"Nirvana Sutra",
      "score":21.344824
    }
  ],
  "cost":10,
  "hits":0
}