Buscar

La API de Search proporciona acceso a los datos de Freebase a partir de una consulta de texto libre. Consulta la Descripción general de la Búsqueda y el Libro de recetas de la Búsqueda para obtener más información sobre cómo crear consultas de búsqueda detalladas.

Solicitud

Solicitud HTTP

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

Parámetros

Todos los parámetros que se indican a continuación son opcionales, pero debes incluir uno de los parámetros query o filter.

Nombre del parámetro	Valor	Descripción
Parámetros opcionales
`as_of_time`	`string`	Es un valor de `as_of_time` de MQL para usar con consultas de `mql_output`.
`callback`	`string`	Nombre del método de JS para las devoluciones de llamada de JSONP.
`cursor`	`integer`	El parámetro `cursor`, junto con el parámetro `limit`, te permite paginar 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`	Restringe la búsqueda a los temas con este ID de dominio de Freebase.
`encode`	`string`	Es la codificación de la respuesta. Puedes usar este parámetro para habilitar la codificación HTML. Los valores aceptables son los siguientes: "`html`": Codifica ciertos caracteres en la respuesta (como etiquetas y signos &) con codificación HTML. "`off`": No se codifica la respuesta. No debes imprimir los resultados directamente en una página web sin antes aplicar el escape de HTML al contenido. (predeterminado)
`exact`	`boolean`	Consulta solo el nombre y las claves exactos.
`filter`	`string`	El parámetro `filter` te permite crear reglas y restricciones más complejas para aplicar a tu búsqueda. El valor de `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 agrupar y establecer la precedencia Para obtener información sobre cómo usar la propiedad `filter`, consulta el Search Cookbook.
`format`	`string`	Es el formato estructural de la respuesta JSON. Los valores aceptables son los siguientes: "`entity`": Es información básica sobre las entidades. (predeterminado) "`ids`": Lista ordenada de `ids` de Freebase. "`mids`": Lista ordenada de `mids` de Freebase.
`indent`	`boolean`	Indica si se deben aplicar sangrías a los resultados JSON.
`lang`	`string`	Es el código del idioma con el que se ejecutará la búsqueda. El valor predeterminado es "en".
`limit`	`integer`	Cantidad máxima de resultados que se mostrarán. De forma predeterminada, se devuelven 20 coincidencias en orden descendente de relevancia, si existen esa cantidad. Se pueden solicitar más o menos coincidencias con el parámetro `limit` con un valor diferente. (Ejemplo).
`mql_output`	`string`	Es la consulta de MQL que se ejecutará en los resultados para extraer más datos. Después de ejecutar la búsqueda, los IDs de los documentos coincidentes se pasan a la consulta de MQL de `mql_output` para recuperar los datos reales sobre las coincidencias. Los resultados de MQL se ordenan según la puntuación de relevancia en orden descendente.
`prefixed`	`boolean`	Coincidencia de prefijo con nombres y alias.
`query`	`string`	Es el término de búsqueda.
`scoring`	`string`	Es el algoritmo de puntuación de relevancia que se usará. Los valores aceptables son los siguientes: "`entity`": Usa Freebase y la clasificación de popularidad de entidades. (predeterminado) "`freebase`": Usa la clasificación de entidades de Freebase. "`schema`": Usa la clasificación del esquema para las propiedades y los tipos.
`spell`	`string`	Solicita sugerencias de "quisiste decir". Los valores aceptables son los siguientes: "`always`": Solicita sugerencias de corrección ortográfica para cualquier búsqueda 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 y alias derivados. No se puede usar con `prefixed`.
`type`	`string`	Restringe la búsqueda a temas con este ID de tipo de Freebase.
`with`	`string`	Es una regla de filtro con la que se debe hacer coincidir.
`without`	`string`	Es una regla de filtro con la que no se debe establecer una coincidencia.

Cuerpo de la solicitud

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

Respuesta

Si la operación se realiza correctamente, 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
}