搜索

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”：为任意查询请求拼写建议（长度至少为三个字符）。
  • "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
}