検索

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

リクエスト

HTTP リクエスト

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

パラメータ

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

パラメータ名	Value	説明
オプションパラメータ
`as_of_time`	`string`	`mql_output` クエリで使用する MQL `as_of_time` 値。
`callback`	`string`	JSONP コールバックの JS メソッド名。
`cursor`	`integer`	`cursor` パラメータと `limit` パラメータを使用すると、定義した数の結果を一度に確認できます。たとえば、3 ページ分連続して 10 ページを表示するには、`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 個が返されます。別の値で `limit` パラメータを使用すると、リクエストできるマッチ数が少なくなります。（例）。
`mql_output`	`string`	再度実行する MQL クエリは結果をさらにリスト化します。クエリが実行されると、一致する docs' 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
}