Поиск

API поиска предоставляет доступ к данным Freebase с помощью произвольного текстового запроса. Пожалуйста, обратитесь к Обзору поиска и Руководству по поиску для получения дополнительной информации о том, как создавать подробные поисковые запросы.

Запрос

HTTP-запрос

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

Параметры

Все параметры ниже являются необязательными, но у вас должен быть либо запрос , либо фильтр .

Имя параметра Ценность Описание
Дополнительные параметры
as_of_time string Значение MQL as_of_time для использования с запросами mql_output .
callback string Имя метода JS для обратных вызовов JSONP.
cursor integer Параметр cursor вместе с параметром limit позволяет просматривать определенное количество результатов за раз. Например, чтобы представить 3 страницы из 10 последовательных результатов, используйте limit=10 и cursor=0 , затем cursor=10 и cursor=20 .
domain string Ограничить темами с этим идентификатором домена Freebase.
encode string Кодировка ответа. Этот параметр можно использовать для включения кодирования HTML.

Допустимые значения:
  • " html ": закодируйте определенные символы в ответе (такие как теги и амперсанды) с помощью кодировки HTML.
  • " off ": Нет кодирования ответа. Вы не должны печатать результаты непосредственно на веб-странице без предварительного HTML-экранирования содержимого. (дефолт)
exact boolean Запрос только по точному имени и ключам.
filter string

Параметр filter позволяет создавать более сложные правила и ограничения для применения к вашему запросу.

Значение filter представляет собой простой язык, который поддерживает следующие символы:

  • операторы all , any , should и not
  • type , domain , name , alias , with операндами и without них
  • скобки ( и ) для группировки и приоритета

Чтобы узнать, как использовать свойство filter , см. Search Cookbook .

format string Структурный формат ответа JSON.

Допустимые значения:
  • " entity ": основная информация о сущностях. (дефолт)
  • " ids ": Упорядоченный список ids Freebase.
  • " mids ": Упорядоченный список mids Freebase.
indent boolean Делать отступ для результатов JSON или нет.
lang string Код языка для выполнения запроса. По умолчанию «en».
limit integer Максимальное количество возвращаемых результатов. По умолчанию возвращается 20 совпадений в порядке убывания релевантности, если таковое существует. Можно запросить меньшее или большее количество совпадений, используя параметр limit с другим значением. ( Пример .)
mql_output string Запрос MQL для обработки результатов для извлечения дополнительных данных. После выполнения запроса идентификаторы совпадающих документов передаются MQL-запросу mql_output для получения фактических данных о совпадениях. Результаты 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.
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
}