搜尋

Search API 可根據任意文字查詢，提供 Freebase 資料的存取權。如要進一步瞭解如何建構詳細的搜尋查詢，請參閱「搜尋總覽」和「搜尋食譜」。

要求

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 用來執行查詢的語言代碼。預設值為「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」：針對長度至少為 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
}