Поиск

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 , см. « Кулинарную книгу поиска» .

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

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