Pesquisar

A API Search fornece acesso a dados do Freebase a partir de uma consulta de texto livre. Consulte Visão geral da pesquisa e o Manual de pesquisa para saber mais sobre como criar consultas de pesquisa detalhadas.

Solicitação

Solicitação HTTP

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

Parâmetros

Todos os parâmetros abaixo são opcionais, mas é necessário ter query ou filtro.

Nome do parâmetro Valor Descrição
Parâmetros opcionais
as_of_time string Um valor as_of_time da MQL a ser usado com consultas mql_output.
callback string Nome do método JS para callbacks de JSONP.
cursor integer O parâmetro cursor e o limit permitem paginar um número definido de resultados por vez. Por exemplo, para apresentar três páginas de 10 resultados sucessivos, use limit=10 e cursor=0, depois cursor=10 e cursor=20.
domain string Restringir a tópicos com este ID de domínio do Freebase.
encode string Codificação da resposta. Você pode usar esse parâmetro para ativar a codificação HTML.

Os valores aceitáveis são:
  • "html": codificar alguns caracteres na resposta (como tags e"e"comercial) usando a codificação HTML.
  • "off": nenhuma codificação da resposta. Não é necessário imprimir os resultados diretamente em uma página da Web sem escapar o conteúdo em HTML primeiro. (padrão)
exact boolean Consultar apenas o nome e as chaves exatos.
filter string

Com o parâmetro filter, é possível criar regras e restrições mais complexas para aplicar à consulta.

O valor filter é uma linguagem simples compatível com os seguintes símbolos:

  • Operadores all, any, should e not
  • os operandos type, domain, name, alias, with e without
  • os parênteses ( e ) para agrupamento e precedência

Para saber como usar a propriedade filter, consulte o Manual de Pesquisa.
format string Formato estrutural da resposta JSON.

Os valores aceitáveis são:
  • "entity": informações básicas sobre as entidades. (padrão)
  • "ids": lista ordenada de Freebase ids.
  • "mids": lista ordenada de Freebase mids.
indent boolean Indica se os resultados JSON serão recuados ou não.
lang string Código do idioma em que a consulta será executada. O padrão é 'en'.
limit integer Número máximo de resultados a serem retornados. Por padrão, são retornadas 20 correspondências em ordem decrescente de relevância, se houver. É possível solicitar menos ou mais correspondências usando o parâmetro limit com um valor diferente. Exemplo.
mql_output string A consulta MQL a ser executada novamente repete os resultados para extrair mais dados. Após a execução da consulta, os IDs de documentos correspondentes #39; são transmitidos para a consulta MQL mql_output para recuperar dados reais sobre as correspondências. Os resultados da MQL são classificados pela diminuição da pontuação de relevância. 
prefixed boolean Os prefixos correspondem a nomes e aliases.
query string Termo de consulta a ser pesquisado.
scoring string Algoritmo de pontuação de relevância a ser usado.

Os valores aceitáveis são:
  • "entity": usar a FreeBase e a classificação de entidade de popularidade. (padrão)
  • "freebase": usar a classificação de entidade do Freebase.
  • "schema": usar a classificação do esquema para propriedades e tipos.
spell string Solicitações 'você quis dizer' sugestões

Os valores aceitáveis são:
  • "always": solicitar sugestões de ortografia para qualquer consulta com pelo menos três caracteres.
  • "no_results": solicitar sugestões de ortografia se nenhum resultado for encontrado.
  • "no_spelling": não solicitar sugestões de ortografia. (padrão)
stemmed boolean Consultar nomes e aliases de origem. Não pode ser usado com prefixed.
type string Restringir a tópicos com esse ID do tipo Freebase.
with string Uma regra de filtro para fazer a correspondência.
without string Uma regra de filtro para não correspondência.

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

Se for bem-sucedida, a resposta será uma estrutura 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
}