Buscar

La API de búsqueda proporciona acceso a los datos de Freebase en función de una consulta de texto libre. Consulta la Descripción general de la Búsqueda y la Guía de soluciones de Búsqueda para obtener más información sobre cómo elaborar consultas de búsqueda detalladas.

Solicitud

Solicitud HTTP

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

Parámetros

Todos los parámetros a continuación son opcionales, pero debe tener uno de los siguientes: query o filter.

Nombre del parámetro	Valor	Descripción
Parámetros opcionales
`as_of_time`	`string`	Un valor `as_of_time` de MQL para usar con consultas `mql_output`
`callback`	`string`	Es el nombre del método JS para las devoluciones de llamada JSONP.
`cursor`	`integer`	El parámetro `cursor` junto con el parámetro `limit` te permiten desplazarte por una cantidad definida de resultados a la vez. Por ejemplo, para presentar 3 páginas de 10 resultados sucesivos, usa `limit=10` y `cursor=0`, luego, `cursor=10` y `cursor=20`.
`domain`	`string`	Restringir a temas con este ID de dominio de Freebase.
`encode`	`string`	La codificación de la respuesta. Puedes usar este parámetro para habilitar la codificación HTML. Los valores aceptables son los siguientes: &cot;`html`" Codifica ciertos caracteres en la respuesta (como etiquetas y signos et) con codificación HTML. "`off`": sin codificación de la respuesta. No deberías imprimir los resultados directamente en una página web sin haber escapado el contenido por HTML. (predeterminado)
`exact`	`boolean`	Consulta solo el nombre exacto y las claves.
`filter`	`string`	El parámetro `filter` te permite crear reglas y restricciones más complejas para aplicar en tu consulta. El valor `filter` es un lenguaje simple que admite los siguientes símbolos: los operadores `all`, `any`, `should` y `not` los operandos `type`, `domain`, `name`, `alias`, `with` y `without` Los paréntesis `(` y `)` para la agrupación y la precedencia Para obtener información sobre cómo usar la propiedad `filter`, consulta el libro de cocina de la Búsqueda.
`format`	`string`	Formato estructural de la respuesta JSON Los valores aceptables son los siguientes: "`entity`": Información básica sobre las entidades. (predeterminado) &`ids`; lista ordenada de Basebase `ids`. &`mids`; lista ordenada de Basebase `mids`.
`indent`	`boolean`	Indica si se debe aplicar sangría a los resultados JSON o no.
`lang`	`string`	El código del lenguaje con el que se ejecuta la consulta. El valor predeterminado es &en'.
`limit`	`integer`	Cantidad máxima de resultados que se mostrarán De forma predeterminada, se muestran 20 coincidencias en orden descendente de relevancia, si son muchas. Se pueden solicitar menos o más coincidencias mediante el parámetro `limit` con un valor diferente. (Ejemplo).
`mql_output`	`string`	La consulta de MQL para ejecutarse vuelve a ejecutar los resultados a fin de extraer más datos. Después de ejecutar la consulta, los ID coincidentes se pasan a la consulta MQL de `mql_output` para recuperar datos reales sobre las coincidencias. Los resultados de MQL se ordenan según el nivel de relevancia decreciente.
`prefixed`	`boolean`	Los prefijos coinciden con nombres y alias.
`query`	`string`	Término de búsqueda para buscar.
`scoring`	`string`	Algoritmo de puntuación de relevancia para usar. Los valores aceptables son los siguientes: &`entity`; ": usar Freebase y la clasificación de la popularidad de la entidad. (predeterminado) "`freebase`": Usa la clasificación de entidades de Freebase. "`schema`": Usa la clasificación de esquema para propiedades y tipos.
`spell`	`string`	Solicitar "Quizás quisiste decir" son sugerencias Los valores aceptables son los siguientes: "`always`": solicita sugerencias ortográficas para cualquier consulta de al menos tres caracteres. &`no_results`; " solicita sugerencias ortográficas si no se encontraron resultados. "`no_spelling`": No solicites sugerencias ortográficas. (predeterminado)
`stemmed`	`boolean`	Consulta sobre nombres derivados y alias. No se puede usar con `prefixed`.
`type`	`string`	Restringe a temas con este ID de tipo Freebase.
`with`	`string`	Una regla de filtro para establecer coincidencias.
`without`	`string`	Una regla de filtro que no debe coincidir.

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si se ejecuta de forma correcta, la respuesta es una estructura 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
}