Suche

Die Search API bietet Zugriff auf Freebase-Daten auf Grundlage einer Freitextanfrage. Weitere Informationen zum Erstellen detaillierter Suchanfragen finden Sie in der Übersicht zur Suche und im Search Cookbook.

Anfrage

HTTP-Anfrage

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

Parameter

Alle Parameter unten sind optional, aber Sie müssen entweder query oder filter angeben.

Parametername Wert Beschreibung
Optionale Parameter
as_of_time string Ein MQL-as_of_time-Wert, der mit mql_output-Abfragen verwendet werden kann.
callback string JS-Methodenname für JSONP-Callbacks.
cursor integer Mit dem Parameter cursor und dem Parameter limit können Sie jeweils eine bestimmte Anzahl von Ergebnissen durchblättern. Wenn Sie beispielsweise drei Seiten mit jeweils 10 aufeinanderfolgenden Ergebnissen präsentieren möchten, verwenden Sie limit=10 und cursor=0, dann cursor=10 und cursor=20.
domain string Auf Themen mit dieser Freebase-Domain-ID beschränken.
encode string Die Codierung der Antwort. Mit diesem Parameter können Sie die HTML-Codierung aktivieren.

Zulässige Werte sind:
  • „html“: Bestimmte Zeichen in der Antwort (z. B. Tags und Et-Zeichen) werden mit HTML-Codierung codiert.
  • „off“: Die Antwort wird nicht codiert. Sie sollten die Ergebnisse nicht direkt auf einer Webseite ausgeben, ohne die Inhalte vorher HTML-zu-escapen. (Standard)
exact boolean Nur nach genauem Namen und Schlüsseln suchen.
filter string

Mit dem Parameter filter können Sie komplexere Regeln und Einschränkungen für Ihre Abfrage erstellen.

Der filter-Wert ist eine einfache Sprache, die die folgenden Symbole unterstützt:

  • die Operatoren all, any, should und not
  • die Operanden type, domain, name, alias, with und without
  • die Klammern ( und ) zum Gruppieren und für die Vorrangregeln

Informationen zur Verwendung der Eigenschaft filter finden Sie im Search Cookbook.
format string Strukturformat der JSON-Antwort.

Zulässige Werte sind:
  • „entity“: grundlegende Informationen zu den Entitäten. (Standard)
  • „ids“: Geordnete Liste der Freebase-ids.
  • „mids“: Geordnete Liste der Freebase-mids.
indent boolean Gibt an, ob die JSON-Ergebnisse eingerückt werden sollen.
lang string Der Code der Sprache, in der die Abfrage ausgeführt werden soll. Der Standardwert ist „en“.
limit integer Maximale Anzahl der zurückzugebenden Ergebnisse. Standardmäßig werden 20 Übereinstimmungen in absteigender Reihenfolge nach Relevanz zurückgegeben, sofern so viele vorhanden sind. Mit dem Parameter limit können Sie eine andere Anzahl von Übereinstimmungen anfordern. (Beispiel)
mql_output string Die MQL-Abfrage, die für die Ergebnisse ausgeführt werden soll, um weitere Daten zu extrahieren. Nachdem die Abfrage ausgeführt wurde, werden die IDs der übereinstimmenden Dokumente an die mql_output-MQL-Abfrage übergeben, um tatsächliche Daten zu den Übereinstimmungen abzurufen. Die MQL-Ergebnisse werden nach absteigendem Relevanzwert sortiert. 
prefixed boolean Präfixabgleich für Namen und Aliase.
query string Suchbegriff, nach dem gesucht werden soll.
scoring string Der zu verwendende Algorithmus für die Relevanzbewertung.

Zulässige Werte sind:
  • „entity“: Freebase und Popularity Entity Ranking verwenden. (Standard)
  • „freebase“: Freebase-Entitätsranking verwenden.
  • schema: Verwenden Sie das Schemaranking für Properties und Typen.
spell string „Meintest du…“-Vorschläge anfordern

Zulässige Werte:
  • „always“: Rechtschreibvorschläge für Suchanfragen mit mindestens drei Zeichen anfordern.
  • „no_results“: Rechtschreibvorschläge anfordern, wenn keine Ergebnisse gefunden wurden.
  • „no_spelling“: Es werden keine Rechtschreibvorschläge angefordert. (Standard)
stemmed boolean Abfrage zu gekürzten Namen und Aliasen Darf nicht mit prefixed verwendet werden.
type string Auf Themen mit dieser Freebase-Typ-ID beschränken.
with string Eine Filterregel, die abgeglichen werden soll.
without string Eine Filterregel, die nicht abgeglichen werden soll.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei erfolgreicher Ausführung ist die Antwort eine JSON-Struktur. 

{
  "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
}