Suche

Über die Search API können Sie mit einer Freitextabfrage auf Freebase-Daten zugreifen. Weitere Informationen zum Erstellen detaillierter Suchanfragen finden Sie in der Übersicht über die Suche und im Cookbook zur Suche.

Anfrage

HTTP-Request

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

Parameter

Alle folgenden Parameter sind optional. Sie müssen jedoch entweder query oder filter angeben.

Parametername Wert Beschreibung
Optionale Parameter
as_of_time string Einen MQL-Wert as_of_time zur Verwendung mit mql_output-Abfragen.
callback string JS-Methodenname für JSONP-Callbacks.
cursor integer Mit dem Parameter cursor und dem Parameter limit können Sie durch eine festgelegte Anzahl von Ergebnissen blättern. Wenn Sie beispielsweise drei Seiten aufeinanderfolgender zehn Ergebnisse 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. Sie können diesen Parameter verwenden, um die HTML-Codierung zu aktivieren.

Zulässige Werte:
  • "html": Hiermit werden bestimmte Zeichen in der Antwort (z. B. Tags und Et-Zeichen) mithilfe der HTML-Codierung codiert.
  • "off": Keine Codierung der Antwort. Sie sollten die Ergebnisse nicht direkt auf einer Webseite drucken, ohne zuerst den HTML-Code maskieren zu müssen. (Standard)
exact boolean Abfrage nur auf genauen Namen und Schlüssel.
filter string

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

Der Wert filter 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 ) für Gruppierung und Priorität

Weitere Informationen zur Verwendung der Property filter findest du unter Search Cookbook.
format string Strukturelles Format der JSON-Antwort.

Zulässige Werte:
  • "entity": Grundlegende Informationen zu den Entitäten. (Standard)
  • "ids": Bestellte Liste der Freebase ids.
  • "mids": Bestellte Liste der Freebase mids.
indent boolean Gibt an, ob die JSON-Ergebnisse eingerückt werden sollen.
lang string Der Code der Sprache, mit der die Abfrage ausgeführt werden soll. Die Standardeinstellung ist 'de'.
limit integer Maximale Anzahl der zurückzugebenden Ergebnisse Standardmäßig werden 20 Übereinstimmungen in absteigender Reihenfolge nach Relevanz zurückgegeben, wenn so viele vorhanden sind. Weniger oder mehr Übereinstimmungen können angefordert werden, indem der Parameter limit mit einem anderen Wert verwendet wird. (Beispiel)
mql_output string Die MQL-Abfrage zum erneuten Ausführen der Ergebnisse zum Extrahieren weiterer Daten. Nachdem die Abfrage ausgeführt wurde, werden die übereinstimmenden Dokumente an die MQL-Abfrage mql_output übergeben, um tatsächliche Daten zu den Übereinstimmungen abzurufen. Die MQL-Ergebnisse werden absteigend nach Relevanz sortiert. 
prefixed boolean Präfixabgleich gegen Namen und Aliasse.
query string Suchbegriff, nach dem gesucht werden soll.
scoring string Der zu verwendende Algorithmus für die Relevanzbewertung.

Zulässige Werte:
  • "entity": Ranking der Freebase und Beliebtheitsentität verwenden. (Standard)
  • "freebase": Freebase-Entitätsranking verwenden.
  • "schema": Schema-Ranking für Eigenschaften und Typen verwenden.
spell string Anfrage für "Meinten Sie"-Vorschläge

Zulässige Werte:
  • "always": Rechtschreibvorschläge für jede Suchanfrage mit mindestens drei Zeichen.
  • "no_results": Rechtschreibvorschläge anfordern, falls keine Ergebnisse gefunden werden.
  • "no_spelling": Rechtschreibvorschläge nicht anfordern. (Standard)
stemmed boolean Abfrage nach Stammnamen und Aliassen Kann nicht mit prefixed verwendet werden.
type string Auf Themen mit dieser Freebase-Typ-ID beschränken.
with string Eine Filterregel für den Abgleich.
without string Eine Filterregel, die nicht abgeglichen werden soll.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Wenn der Vorgang erfolgreich war, 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
}