搜索

搜索 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
}