Pesquisar

A API Search dá acesso aos dados da Freebase com base em uma consulta de texto livre. Consulte a Visão geral da pesquisa e o Manual de receitas da pesquisa para mais informações 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 você precisa ter uma consulta ou um filtro.

Nome do parâmetro Valor Descrição
Parâmetros opcionais
as_of_time string Um valor as_of_time do MQL para usar com consultas mql_output.
callback string Nome do método JS para callbacks JSONP.
cursor integer O parâmetro cursor e o parâmetro limit permitem que você navegue por 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 Restringe a tópicos com este ID de domínio da Freebase.
encode string A codificação da resposta. Use esse parâmetro para ativar a codificação HTML.

Os valores aceitáveis são:
  • "html": codifique determinados caracteres na resposta (como tags e e comerciais) usando a codificação HTML.
  • "off": sem codificação da resposta. Não imprima os resultados diretamente em uma página da Web sem fazer o escape de HTML do conteúdo 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 à sua consulta.

O valor filter é uma linguagem simples que aceita os seguintes símbolos:

  • os 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 receitas 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 ids do Freebase.
  • "mids": lista ordenada de mids do Freebase.
indent boolean Se os resultados JSON devem ser recuados ou não.
lang string O 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, 20 correspondências em ordem decrescente de relevância são retornadas, se houver essa quantidade. É possível solicitar mais ou menos correspondências usando o parâmetro limit com um valor diferente. (Exemplo.)
mql_output string A consulta MQL a ser executada nos resultados para extrair mais dados. Depois que a consulta é executada, os IDs dos documentos correspondentes são transmitidos para a consulta em MQL do mql_output para recuperar dados reais sobre as correspondências. Os resultados da MQL são classificados por pontuação de relevância decrescente. 
prefixed boolean Correspondência de prefixo com 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": usa o Freebase e a classificação de entidades por popularidade. (padrão)
  • "freebase": use o ranking de entidades da Freebase.
  • "schema": use a classificação de esquema para propriedades e tipos.
spell string Solicitar sugestões de "Você quis dizer"

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

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
}