搜尋

Search API 可讓您免費取得存取自由文字查詢到的 Basebase 資料。請參閱搜尋總覽和搜尋食譜，進一步瞭解如何建立詳細的搜尋查詢。

要求

HTTP 要求

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

參數

下列所有參數皆為選用，但您必須具有 query 或 filter 其中之一。

參數名稱 值 說明
選用參數
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 執行查詢時所使用的語言程式碼。預設值為 ##9;en'。
limit integer 要傳回的結果數量上限。根據預設，系統會傳回 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"：要求對任何查詢長度至少三個字元的拼字建議。
  • "no_results"：找不到相符的結果時要求拼字建議。
  • "no_spelling": Don't 要求拼寫建議。 (預設)
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
}