搜索

Search API 允许通过自由文本查询访问 Freebase 数据。如需详细了解如何构建详细的搜索查询,请参阅搜索概览搜索实战宝典

请求

HTTP 请求

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

参数

以下所有参数均为可选,但您必须拥有 queryfilter 中的一个。

参数名称 说明
可选参数
as_of_time string mql_output 查询搭配使用的 MQL as_of_time 值。
callback string 用于 JSONP 回调的 JS 方法名称。
cursor integer 借助 cursor 参数和 limit 参数,您可以一次浏览指定数量的结果。例如,如需显示 3 个连续的 10 个结果,请使用 limit=10cursor=0,然后分别使用 cursor=10cursor=20
domain string 仅限具有此 Freebase 网域 ID 的主题。
encode string 响应的编码。您可以使用此参数来启用 HTML 编码。

可接受的值:
  • "html”:使用 HTML 编码对响应中的某些字符(例如标记&符号)进行编码。
  • "off”:没有对响应进行编码。请勿在不进行 HTML 转义的情况下直接将结果输出到网页上。 (默认)
exact boolean 仅查询确切的名称和键。
filter string

借助 filter 参数,您可以创建要应用于查询的更复杂的规则和限制条件。

filter 值是一种简单语言,支持以下符号:

  • allanyshouldnot 运算符
  • typedomainnamealiaswithwithout 操作数
  • 用于分组和优先级的 () 括号

如需了解如何使用 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
}