XML API-Referenz

Diese Seite bezieht sich auf die XML-Version der Custom Search JSON API, die nur für Kunden von Google Site Search verfügbar ist.

  1. Übersicht
  2. Anfrageformat der Programmable Search Engine
    1. Anfrageübersicht
    2. Suchbegriffe
    3. Anfrageparameter
      1. Beispiele für WebSearch-Suchanfragen
      2. Definitionen der WebSearch-Suchparameter
      3. Erweiterte Suche
      4. Erweiterte Suchparameter
      5. Spezielle Suchbegriffe
      6. Beispiele für Bild-Suchanfragen
      7. Suchparameter für die Bildersuche
      8. Anfragelimits
    4. Präsentation zur Internationalisierung von Abfragen und Ergebnissen
      1. Zeichencodierung
      2. Schnittstellensprachen
      3. Chinesisch (vereinfacht und traditionell)
    5. Ergebnisse filtern
      1. Suchergebnisse automatisch filtern
      2. Nach Sprache und Land filtern
      3. Inhalte nur für Erwachsene mit SafeSearch filtern
  3. XML-Ergebnisse
    1. Google-XML-Ergebnis-DTD
    2. Informationen zur XML-Antwort
    3. XML-Ergebnisse für reguläre Suchanfragen, Bildabfragen und erweiterte Suchanfragen
      1. Reguläre/erweiterte Suche: Beispielabfrage und XML-Ergebnis
      2. Normale/erweiterte Suche: XML-Tags
      3. XML-Ergebnisse für Bildersuche
      4. Bildersuche: Beispielabfrage und XML-Ergebnis
      5. Bildersuche: XML-Tags

Überblick

Mit Google WebSearch können Kunden von Google Site Search Google-Suchergebnisse auf ihren eigenen Websites anzeigen. Der WebSearch-Dienst verwendet für die Bereitstellung von Suchergebnissen ein einfaches HTTP-basiertes Protokoll. Administratoren für die Suche haben die vollständige Kontrolle darüber, wie sie Suchergebnisse anfordern und wie sie sie dem Endnutzer präsentieren. In diesem Dokument werden die technischen Details der Google-Suchanfrage und der Ergebnisformate beschrieben.

Zum Abrufen von Google WebSearch-Ergebnissen sendet Ihre Anwendung eine einfache HTTP-Anfrage an Google. Google gibt Suchergebnisse dann im XML-Format zurück. Mit XML-formatierten Ergebnissen können Sie die Anzeige der Suchergebnisse anpassen.

WebSearch-Anfrageformat

Anfragen – Übersicht

Die Google-Suchanfrage ist ein Standard-HTTP-GET-Befehl. Es enthält eine Sammlung von Parametern, die für Ihre Abfragen relevant sind. Diese Parameter sind in der Anfrage-URL als Name=Wert-Paare enthalten, getrennt durch kaufmännische Und-Zeichen (&). Parameter enthalten Daten wie die Suchanfrage und eine eindeutige Suchmaschinen-ID (cx), die die Suchmaschine identifiziert, von der die HTTP-Anfrage ausgeht. Der Dienst WebSearch oder Bildersuche gibt als Antwort auf Ihre HTTP-Anfragen XML-Ergebnisse zurück.

Suchbegriffe

Die meisten Suchanfragen enthalten einen oder mehrere Suchbegriffe. Ein Suchbegriff wird als Wert eines Parameters in der Suchanfrage angezeigt.

Mit Suchbegriffen können verschiedene Arten von Informationen angegeben werden, um die von Google zurückgegebenen Suchergebnisse zu filtern und zu organisieren. In Abfragen kann Folgendes angegeben werden:

  • Ein- oder auszuschließende Wörter oder Wortgruppen
    • Alle Wörter in einer Suchanfrage (Standardeinstellung)
    • Eine genaue Wortgruppe in der Suchanfrage
    • Beliebige Wörter oder Wortgruppen in einer Suchanfrage
  • Wo im Dokument nach den Suchbegriffen gesucht werden soll
    • Beliebige Stelle im Dokument (Standardeinstellung)
    • Nur im Textbereich des Dokuments
    • Nur im Titel des Dokuments
    • Nur in der Dokument-URL
    • Nur in Links im Dokument
  • Einschränkungen für die Dokumente selbst
    • Ein- oder Ausschließen von Dokumenten bestimmter Dateitypen (z. B. PDF-Dateien oder Word-Dokumente)
  • Spezielle URL-Suchanfragen, die Informationen zu einer bestimmten URL zurückgeben, anstatt eine Suche durchzuführen.
    • Abfragen, bei denen allgemeine Informationen zu einer URL zurückgegeben werden, z. B. Open Directory-Kategorie, -Snippet oder -Sprache
    • Suchanfragen, bei denen die Webseiten zurückgegeben werden, die auf eine URL verweisen
    • Suchanfragen, die eine Reihe von Webseiten zurückgeben, die einer bestimmten URL ähnlich sind

Standardsuche

Die Werte der Suchparameter müssen URL-Escaping sein. Beachten Sie, dass Sie das Pluszeichen ("+") durch alle Leerzeichenfolgen in der Suchanfrage ersetzen würden. Dies wird im Abschnitt URL-Escaping dieses Dokuments näher erläutert.

Der Suchbegriff wird mit dem Parameter q an den WebSearch-Dienst gesendet. Hier ein Beispiel für einen Suchbegriff:

q=horses+cows+pigs

Standardmäßig gibt der Google WebSearch-Dienst nur Dokumente zurück, die alle Begriffe der Suchanfrage enthalten.

Anforderungsparameter

In diesem Abschnitt sind die Parameter aufgeführt, die Sie bei einer Suchanfrage verwenden können. Die Parameter werden in zwei Listen aufgeteilt. Die erste Liste enthält Parameter, die für alle Suchanfragen relevant sind. Die zweite Liste enthält Parameter, die nur für erweiterte Suchanfragen relevant sind.

Drei Anfrageparameter sind erforderlich:

  • Der Parameter client muss auf google-csbe festgelegt sein
  • Der output-Parameter gibt das Format der zurückgegebenen XML-Ergebnisse an. Ergebnisse können mit (xml) oder ohne (xml_no_dtd) eines Verweises auf die DTD von Google zurückgegeben werden. Wir empfehlen, diesen Wert auf xml_no_dtd festzulegen. Hinweis: Wenn Sie diesen Parameter nicht angeben, werden die Ergebnisse in HTML und nicht in XML zurückgegeben.
  • Der Parameter cx, der die eindeutige ID der Suchmaschine darstellt.

Neben den oben genannten sind die am häufigsten verwendeten Anfrageparameter:

  • num: die angeforderte Anzahl von Suchergebnissen
  • q: Suchbegriff(e)
  • start: der Startindex für die Ergebnisse

Beispiele für WebSearch-Suchanfragen

Die folgenden Beispiele zeigen einige WebSearch-HTTP-Anfragen, um die Verwendung verschiedener Abfrageparameter zu veranschaulichen. Definitionen für die verschiedenen Abfrageparameter finden Sie in diesem Dokument in den Abschnitten Definitionen von WebSearch-Suchparametern und Erweiterte Suchparameter.

Diese Anfrage fordert die ersten zehn Ergebnisse (start=0&num=10) für den Suchbegriff „red sox“ (q=red+sox) an. Außerdem gibt die Abfrage an, dass Ergebnisse von kanadischen Websites (cr=countryCA) stammen und auf Französisch (lr=lang_fr) verfasst werden sollen. Schließlich gibt die Abfrage Werte für die Parameter client, output und cx an, von denen alle drei erforderlich sind.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

In diesem Beispiel werden einige der Parameter für erweiterte Suchanfragen verwendet, um die Suchanfrage weiter anzupassen. In dieser Anfrage wird der Parameter as_q (as_q=red+sox) anstelle des Parameters q verwendet. Außerdem wird der Parameter as_eq verwendet, um Dokumente, die das Wort "Yankees" enthalten, aus den Suchergebnissen (as_eq=yankees) auszuschließen.

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Definitionen der WebSearch-Suchparameter

c2coff
Beschreibung

Optional: Mit dem Parameter c2coff wird die Funktion für die Suche in vereinfachtem und traditionellem Chinesisch aktiviert oder deaktiviert.

Der Standardwert für diesen Parameter ist 0 (null). Dies bedeutet, dass das Feature aktiviert ist. Werte für den Parameter c2coff sind:

Wert Aktion
1 Deaktiviert
0 Aktiviert
Beispiele q=google&c2coff=1

client
Beschreibung

Erforderlich. Der Parameter client muss auf google-csbe festgelegt sein.
Beispiele q=google&client=google-csbe

cr
Beschreibung

Optional: Der Parameter cr beschränkt Suchergebnisse auf Dokumente, die aus einem bestimmten Land stammen. Sie können im Wert des Parameters cr Boolesche Operatoren verwenden.

Google WebSearch ermittelt das Land eines Dokuments durch die Analyse:

  • die Top-Level-Domain (TLD) der Dokument-URL
  • den geografischen Standort der IP-Adresse des Webservers

Im Abschnitt Werte für Länderparameter (cr) finden Sie eine Liste der gültigen Werte für diesen Parameter.
Beispiele q=Frodo&cr=countryNZ

cx
Beschreibung

Erforderlich. Der Parameter cx gibt einen eindeutigen Code an, der eine benutzerdefinierte Suchmaschine identifiziert. Sie müssen eine Programmable Search Engine mit dem Parameter cx angeben, um Suchergebnisse von dieser Suchmaschine abzurufen.

Um den Wert des Parameters cx zu finden, wechseln Sie in Ihrer Suchmaschine zum Tab „Steuerfeld“ > „Codes“. Sie finden ihn im Textfeld unter „Diesen Code einfügen“ auf der Seite, auf der Ihr Suchfeld angezeigt werden soll. Die Suchergebnisse werden auf einer von Google gehosteten Seite angezeigt."
Beispiele q=Frodo&cx=00255077836266642015:u-scht7a-8i

Filter
Beschreibung

Optional: Der Parameter filter aktiviert oder deaktiviert die automatische Filterung von Google-Suchergebnissen. Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie im Abschnitt Automatische Filterung in diesem Dokument.

Der Standardwert für den Parameter filter ist 1. Dies bedeutet, dass das Feature aktiviert ist. Gültige Werte für diesen Parameter sind:

Wert Aktion
1 Deaktiviert
0 Aktiviert

Hinweis:Standardmäßig wendet Google Filter auf alle Suchergebnisse an, um die Qualität dieser Ergebnisse zu verbessern.
Beispiele q=google&filter=0

gl
Beschreibung

Optional: Der Parameterwert gl ist ein zweistelliger Ländercode. Bei WebSearch-Ergebnissen verbessert der Parameter gl Suchergebnisse, deren Ursprungsland mit dem Parameterwert übereinstimmt. Eine Liste der gültigen Werte finden Sie im Abschnitt Ländercodes.

Durch Angabe eines gl-Parameterwerts in WebSearch-Anfragen sollte die Relevanz der Ergebnisse verbessert werden. Dies gilt insbesondere für internationale Kunden und insbesondere für Kunden in englischsprachigen Ländern außer den USA.
Beispiele

Durch diese Anfrage werden im Vereinigten Königreich verfasste Dokumente in WebSearch-Ergebnissen verbessert:
q=pizza&gl=uk

hl
Beschreibung

Optional: Der Parameter hl gibt die Sprache der Benutzeroberfläche (Hostsprache) der Benutzeroberfläche an. Es wird dringend empfohlen, diesen Parameter explizit festzulegen, um die Leistung und Qualität Ihrer Suchergebnisse zu verbessern.

Weitere Informationen finden Sie im Abschnitt Schnittstellensprachen der Präsentation zur Internationalisierung von Abfragen und Ergebnissen. Eine Liste der unterstützten Sprachen finden Sie unter Unterstützte Schnittstellensprachen.
Beispiele

Diese Anfrage ist auf Anzeigen für Wein in französischer Sprache ausgerichtet. Vin ist der französische Begriff für Wein.

q=vin&ip=10.10.10.10&ad=w5&hl=fr

HQ
Beschreibung

Optional: Mit dem Parameter hq werden die angegebenen Suchbegriffe so an die Abfrage angehängt, als wären sie mit einem logischen UND-Operator kombiniert worden.

Beispiele

Diese Anfrage sucht nach „Pizza“ UND „Käse“. Der Ausdruck ist mit q=pizza+cheese identisch.

q=pizza&hq=cheese

ie
Beschreibung

Optional: Mit dem Parameter ie wird das Zeichencodierungsschema festgelegt, das zur Interpretation des Abfragestrings verwendet werden soll. Der Standardwert für ie ist latin1.

Im Abschnitt Zeichencodierung finden Sie Informationen zur Verwendung dieses Parameters.

Die Liste der möglichen ie-Werte finden Sie im Abschnitt Zeichencodierungsschemas.
Beispiele q=google&ie=utf8&oe=utf8
lr
Beschreibung

Optional: Der Parameter lr (languagerestrict) beschränkt Suchergebnisse auf Dokumente, die in einer bestimmten Sprache verfasst sind.

Die Sprache eines Dokuments wird mit Google WebSearch anhand folgender Daten bestimmt:

  • die Top-Level-Domain (TLD) der Dokument-URL
  • Meta-Tags für die Sprache innerhalb des Dokuments
  • die im Textkörper des Dokuments verwendete Hauptsprache
  • Im Textkörper des Dokuments werden sekundäre Sprachen, falls vorhanden, verwendet.

Im Abschnitt Erfassungswerte für Sprache (lr) finden Sie eine Liste der gültigen Werte für diesen Parameter.
Beispiele q=Frodo&lr=lang_en

num
Beschreibung

Optional: Der Parameter num gibt die Anzahl der zurückzugebenden Suchergebnisse an.

Der Standardwert für num ist 10 und der Höchstwert ist 20. Wenn Sie mehr als 20 Ergebnisse anfordern, werden nur 20 Ergebnisse zurückgegeben.

Hinweis: Wenn die Gesamtzahl der Suchergebnisse kleiner als die angeforderte Anzahl ist, werden alle verfügbaren Suchergebnisse zurückgegeben.
Beispiele q=google&num=10

oe
Beschreibung

Optional: Der Parameter oe legt das Zeichencodierungsschema fest, das zum Decodieren des XML-Ergebnisses verwendet werden soll. Der Standardwert für oe ist latin1.

Im Abschnitt Zeichencodierung finden Sie Informationen zur Verwendung dieses Parameters.

Die Liste der möglichen oe-Werte finden Sie im Abschnitt Zeichencodierungsschemas.
Beispiele q=google&ie=utf8&oe=utf8

output
Beschreibung

Erforderlich. Der Parameter output gibt das Format der XML-Ergebnisse an. Die einzigen gültigen Werte für diesen Parameter sind xml und xml_no_dtd. In der folgenden Tabelle wird erläutert, wie sich diese Parameterwerte unterscheiden.

Wert Ausgabeformat
xml_no_dtd Die XML-Ergebnisse enthalten keine !DOCTYPE-Anweisung. (Empfohlen)
xml Die XML-Ergebnisse enthalten eine Google-DTD-Referenz. Die zweite Zeile des Ergebnisses gibt den Dokumentdefinitionstyp (DTD) an, den die Ergebnisse verwenden: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
Beispiele output=xml_no_dtd
output=xml

q
Beschreibung

Optional: Der Parameter q gibt die vom Nutzer eingegebene Suchanfrage an. Auch wenn dieser Parameter optional ist, müssen Sie für mindestens einen der Abfrageparameter einen Wert (as_epq, as_lq, as_oq, as_q) angeben, um Suchergebnisse zu erhalten.

Außerdem gibt es eine Reihe von speziellen Suchbegriffen, die als Teil des Werts des Parameters q verwendet werden können. Eine Liste und Definitionen dieser Begriffe finden Sie unter Spezielle Suchbegriffe.

Das Steuerfeld für die Google Suche enthält einen Bericht zu den häufigsten Suchanfragen, die mit dem Parameter q eingereicht wurden.

Hinweis:Der für den Parameter q angegebene Wert muss URL-Escaping sein.
Beispiele q=vacation&as_oq=london+paris

sicher
Beschreibung

Optional: Mit dem Parameter safe wird angegeben, wie Suchergebnisse nach nicht jugendfreien und pornografischen Inhalten gefiltert werden sollen. Der Standardwert für den Parameter safe ist off. Gültige Parameterwerte:

Wert Aktion
off SafeSearch deaktivieren
medium SafeSearch aktivieren
high Strengere Version von SafeSearch aktivieren

Weitere Informationen zu dieser Funktion finden Sie im Abschnitt Inhalte nur für Erwachsene mit SafeSearch filtern.
Beispiele q=adult&safe=high

start
Beschreibung

Optional: Der Parameter start gibt das erste übereinstimmende Ergebnis an, das in den Suchergebnissen enthalten sein soll. Der Parameter start verwendet einen nullbasierten Index, d. h. das erste Ergebnis ist 0, das zweite Ergebnis 1 usw.

Der Parameter start bestimmt zusammen mit dem Parameter num, welche Suchergebnisse zurückgegeben werden sollen. Beachten Sie, dass nie mehr als 1.000 Ergebnisse für eine Abfrage zurückgegeben werden, selbst wenn mehr als 1.000 Dokumente mit der Abfrage übereinstimmen. Wenn Sie "start" auf 1.000 oder mehr festlegen, erhalten Sie also keine Ergebnisse.
Beispiele start=10

sort
Beschreibung

Optional: Der Parameter sort gibt an, dass die Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sortieren Sie beispielsweise nach Datum.
Beispiele

sort=date

Ud
Beschreibung

Optional: Der Parameter ud gibt an, ob die XML-Antwort die IDN-codierte URL für das Suchergebnis enthalten soll. Mit der IDN-Codierung (International Domain Name) können Domains in den jeweiligen lokalen Sprachen angezeigt werden. Beispiele:

http://www.花井鮨.com

Gültige Werte für diesen Parameter sind 1 (Standardwert), das XML-Ergebnis sollte also IDN-codierte URLs enthalten, und 0, d. h. das XML-Ergebnis sollte keine IDN-codierten URLs enthalten. Wenn der Parameter ud auf 1 gesetzt ist, wird die IDN-codierte URL in Ihren XML-Ergebnissen im UD-Tag angezeigt.

Wenn der Parameter ud auf 0 gesetzt ist, wird die URL im Beispiel oben so angezeigt:

http://www.xn--elq438j.com.

Hinweis:Dies ist eine Betafunktion.
Beispiele q=google&ud=1

Die zusätzlichen Suchparameter, die unter dem Bild aufgeführt sind, sind für erweiterte Suchanfragen relevant. Wenn Sie eine erweiterte Suche senden, werden die Werte mehrerer Parameter (z.B. as_eq, as_epq, as_oq usw.) in die Suchbegriffe für diese Suche einbezogen. Das Bild zeigt die Seite „Erweiterte Suche“ von Google. Auf dem Bild steht der Name jedes Parameters für die erweiterte Suche in red Schrift in oder neben dem Feld auf der Seite, dem der Parameter entspricht.



Erweiterte Suchanfragenparameter

as_dt
Beschreibung

Optional: Mit dem Parameter as_dt wird festgelegt, ob Ergebnisse von der im as_sitesearch-Parameter genannten Website ein- oder ausgeschlossen werden. Die Werte i und e geben einen ein- bzw. einen Ausschluss an.
Beispiele as_dt=i,as_dt=e

as_epq
Beschreibung

Optional: Der Parameter as_epq gibt eine Wortgruppe an, die alle Dokumente in den Suchergebnissen enthalten müssen. Sie können auch den Suchbegriff Passende Wortgruppe verwenden, um nach einer Wortgruppe zu suchen.
Beispiele as_epq=abraham+lincoln

as_eq
Beschreibung

Optional: Der Parameter as_eq gibt ein Wort oder eine Wortgruppe an, das bzw. die in keinem Dokument in den Suchergebnissen enthalten sein soll. Sie können auch den Suchbegriff ausschließen verwenden, um sicherzustellen, dass ein bestimmtes Wort oder eine bestimmte Wortgruppe nicht in den Dokumenten in einer Reihe von Suchergebnissen vorkommt.
Beispiele

q=bass&as_eq=music.

as_lq
Beschreibung

Optional: Der Parameter as_lq gibt an, dass alle Suchergebnisse einen Link zu einer bestimmten URL enthalten sollen. Sie können für diesen Abfragetyp auch den Suchbegriff link: verwenden.

Beispiele

as_lq=www.google.com

as_nlo
Beschreibung

Optional: Der Parameter as_nlo gibt den Startwert für einen Suchbereich an. Verwenden Sie as_nlo und as_nhi, um einen inklusiven Suchbereich von as_nlo...as_nhi an die Abfrage anzufügen.

Beispiele

Hier wird ein Suchbereich von 5 bis einschließlich 10 festgelegt:

as_nlo=5&as_nhi=10
as_nhi
Beschreibung

Optional: Der Parameter as_nhi gibt den Endwert für einen Suchbereich an. Verwenden Sie as_nlo und as_nhi, um einen inklusiven Suchbereich von as_nlo...as_nhi an die Abfrage anzuhängen.
Beispiele

Hier wird ein Suchbereich von 5 bis einschließlich 10 festgelegt:

as_nlo=5&as_nhi=10
as_oq
Beschreibung

Optional: Der Parameter as_oq stellt zusätzliche Suchbegriffe bereit, nach denen in einem Dokument gesucht werden soll. Dabei muss jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten. Sie können für diese Art von Abfrage auch den Booleschen OR-Abfragebegriff verwenden.
Beispiele

q=vacation&as_oq=London+Paris

as_q
Beschreibung

Optional: Der Parameter as_q gibt Suchbegriffe an, nach denen in einem Dokument gesucht werden soll. Dieser Parameter wird auch häufig verwendet, um Nutzern die Angabe zusätzlicher Begriffe zu ermöglichen, nach denen innerhalb einer Gruppe von Suchergebnissen gesucht werden soll.
Beispiele

q=president&as_q=John+Adams

as_qdr
Beschreibung

Optional: Mit dem Parameter as_qdr werden Suchergebnisse aus einem bestimmten Zeitraum (schneller Zeitraum) angefordert. Folgende Werte werden unterstützt:

d[number] fordert Ergebnisse für die angegebene Anzahl der letzten Tage an.
w[number] fordert Ergebnisse für die angegebene Anzahl der vergangenen Wochen an.
m[number] fordert Ergebnisse für die angegebene Anzahl vergangener Monate an.
y[number] fordert Ergebnisse aus der angegebenen Anzahl vergangener Jahre an.
Beispiele

In diesem Beispiel werden Ergebnisse aus dem letzten Jahr angefordert:

as_qdr=y

In diesem Beispiel werden Ergebnisse der letzten 10 Tage angefordert:

as_qdr=d10
as_sitesearch
Beschreibung

Optional: Mit dem Parameter as_sitesearch können Sie angeben, dass alle Suchergebnisse Seiten von einer bestimmten Website sein sollen. Wenn Sie den as_dt-Parameter festlegen, können Sie damit auch Seiten einer bestimmten Website aus Ihren Suchergebnissen ausschließen.
Beispiele

q=vacation&as_sitesearch=www.google.com

Spezielle Suchbegriffe

Mit Google WebSearch können verschiedene spezielle Suchbegriffe verwendet werden, mit denen auf zusätzliche Funktionen der Google-Suchmaschine zugegriffen werden kann. Diese speziellen Suchbegriffe sollten im Wert des Anfrageparameters q enthalten sein. Genau wie andere Suchbegriffe müssen auch die speziellen Suchbegriffe URL-Escaping verwendet werden. Eine Reihe der speziellen Suchbegriffe enthält einen Doppelpunkt (:). Dieses Zeichen muss auch URL-Escaping sein. Der Wert ist %3A.

Backlinks [link:]
Beschreibung

Der Abfragebegriff link: ruft eine Gruppe von Webseiten ab, die mit einer bestimmten URL verknüpft sind. Die Suchanfrage sollte das Format link:URL haben. Zwischen dem Suchbegriff link: und der URL darf kein Leerzeichen stehen.

Die URL-Version von link: ist link%3A.

Sie können auch den Anfrageparameter as_lq verwenden, um eine link:-Anfrage zu senden.

Hinweis: Sie können keine anderen Suchbegriffe angeben, wenn Sie link: verwenden.
Beispiele

http://www.google.com/search?q=link%3Awww.example.com

Boolesch OR Suche [ OR ]
Beschreibung

Mit dem Abfragebegriff OR werden Dokumente abgerufen, die einen aus einer Reihe von (zwei oder mehr) Suchbegriffen enthalten. Um den Abfragebegriff OR zu verwenden, fügen Sie zwischen den einzelnen Begriffen in der Serie den Suchbegriff OR in Großbuchstaben ein.

Sie können auch den Anfrageparameter as_oq verwenden, um eine Suche nach einem beliebigen Begriff in einer Gruppe von Begriffen zu senden.

Hinweis:Wenn in einer Suchanfrage die Abfrage "London+OR+Paris" angegeben ist, enthalten die Suchergebnisse Dokumente, die mindestens eines dieser beiden Wörter enthalten. In einigen Fällen können Dokumente in den Suchergebnissen beide Wörter enthalten.
Beispiele

Nach London oder Paris suchen:

Nutzereingabe:london OR paris Suchbegriff:q=london+OR+paris

Nach Urlaub und entweder London oder Paris suchen:

Suchbegriff:q=vacation+london+OR+paris

Suche nach Urlaub und nach London, Paris oder Pralinen:

Suchbegriff:  q=vacation+london+OR+paris+OR+chocolates

Suchen Sie nach Urlaub und Pralinen und entweder nach London oder Paris, wobei Pralinen das geringste Gewicht erhalten:

Suchbegriff:  q=vacation+london+OR+paris+chocolates

Suchen Sie in Dokumenten, die auch London oder Paris enthalten, nach Urlaub, Pralinen und Blumen:

Suchbegriff:  q=vacation+london+OR+paris+chocolates+flowers

Suchen Sie nach Urlaub und entweder London oder Paris oder nach Pralinen oder Blumen:

Suchbegriff:  q=vacation+london+OR+paris+chocolates+OR+flowers

Suchbegriff ausschließen [-]
Beschreibung

Der Begriff „Ausschließen“ (-) schränkt die Ergebnisse für eine bestimmte Suchanfrage auf Dokumente ein, die kein bestimmtes Wort oder eine bestimmte Wortgruppe enthalten. Wenn Sie den Begriff „Ausschließen“ verwenden möchten, stellen Sie dem Wort oder der Wortgruppe, die aus den übereinstimmenden Dokumenten ausgeschlossen werden soll, ein „-“ (Minuszeichen) voran.

Die URL-Version von - ist %2D.

Der Begriff „Ausschließen“ ist nützlich, wenn ein Suchbegriff mehr als eine Bedeutung hat. Zum Beispiel könnte das Wort „Barsch“ Ergebnisse zu Fisch oder Musik zurückgeben. Wenn Sie nach Dokumenten über Fisch suchen, können Sie Dokumente über Musik aus den Suchergebnissen ausschließen, indem Sie den Suchbegriff „Ausschließen“ verwenden.

Sie können auch den Anfrageparameter as_eq verwenden, um Dokumente, die mit einem bestimmten Wort oder einer bestimmten Wortgruppe übereinstimmen, aus den Suchergebnissen auszuschließen.
Beispiele Nutzereingabe: bass -music
Suchbegriff: q=bass+%2Dmusic

Ausschluss von Dateitypen [ -filetype: ]
Beschreibung

Der Abfragebegriff -filetype: schließt Dokumente mit einer bestimmten Dateiendung wie „.pdf“ oder „.doc“ aus den Suchergebnissen aus. Die Suchanfrage sollte das Format -filetype:EXTENSION haben. Zwischen dem Suchbegriff -filetype: und der angegebenen Erweiterung darf kein Leerzeichen stehen.

Die URL-Version von -filetype: ist %2Dfiletype%3A.

Hinweis: Sie können mehrere Dateitypen aus den Suchergebnissen ausschließen, indem Sie Ihrer Abfrage weitere -filetype:-Suchbegriffe hinzufügen. Ihre Suchanfrage sollte einen -filetype:-Suchbegriff für jede Dateiendung enthalten, die aus den Suchergebnissen ausgeschlossen werden soll.

Google unterstützt u. a. die folgenden Dateitypen:

  • Adobe Portable Document Format (PDF)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (Wo.1, WK2, WK3, WK4, WK5, WK, WK, WKU)
  • Lotus WordPro (lwp)
  • MacWrite (mw)
  • Microsoft Excel (XLS)
  • Microsoft PowerPoint (PPT)
  • Microsoft Word (DOC)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich-Text-Format (RTF)
  • Shockwave Flash (SWF)
  • Text (ans, txt).

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie jederzeit in den FAQ zu Dateitypen von Google.
Beispiele

In diesem Beispiel werden Dokumente zurückgegeben, in denen „Google“ erwähnt wird, die aber keine PDF-Dokumente sind:
q=Google+%2Dfiletype%3Apdf

In diesem Beispiel werden Dokumente zurückgegeben, in denen „Google“ erwähnt wird, aber sowohl PDF- als auch Word-Dokumente ausgeschlossen sind:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Dateitypfilterung [ filetype: ]
Beschreibung

Der Abfragebegriff filetype: beschränkt Suchergebnisse auf Dokumente mit einer bestimmten Dateiendung, z. B. „.pdf“ oder „.doc“. Die Suchanfrage sollte das Format filetype:EXTENSION haben. Zwischen dem Suchbegriff filetype: und der angegebenen Erweiterung darf kein Leerzeichen stehen.

Die URL-Version von filetype: ist filetype%3A.

Sie können die Suchergebnisse auf Dokumente beschränken, die mit einer von mehreren Dateiendungen übereinstimmen. Fügen Sie dazu Ihrer Abfrage weitere filetype:-Suchbegriffe hinzu. Ihre Suchanfrage sollte einen filetype:-Suchbegriff für jede Dateiendung enthalten, die in den Suchergebnissen enthalten sein soll. Mehrere filetype:-Suchbegriffe müssen durch OR getrennt werden.

Standardmäßig enthalten die Suchergebnisse Dokumente mit einer beliebigen Dateiendung.

Google unterstützt u. a. die folgenden Dateitypen:

  • Adobe Portable Document Format (PDF)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (Wo.1, WK2, WK3, WK4, WK5, WK, WK, WKU)
  • Lotus WordPro (lwp)
  • MacWrite (mw)
  • Microsoft Excel (XLS)
  • Microsoft PowerPoint (PPT)
  • Microsoft Word (DOC)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich-Text-Format (RTF)
  • Shockwave Flash (SWF)
  • Text (ans, txt).

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie jederzeit in den FAQ zu Dateitypen von Google.
Beispiele

In diesem Beispiel werden PDF-Dokumente zurückgegeben, in denen „Google“ erwähnt wird:
q=Google+filetype%3Apdf

Dieses Beispiel gibt PDF- und Word-Dokumente zurück, in denen „Google“ erwähnt wird:
q=Google+filetype%3Apdf+OR+filetype%3Adoc

Suchbegriff einschließen [+]
Beschreibung

Der Suchbegriff „Einschließen“ (+) gibt an, dass ein Wort oder eine Wortgruppe in allen Dokumenten enthalten sein muss, die in den Suchergebnissen enthalten sind. Wenn Sie den Suchbegriff „Einschließen“ verwenden möchten, stellen Sie dem Wort oder der Wortgruppe, die in allen Suchergebnissen enthalten sein müssen, ein Pluszeichen „+“ voran.

Die URL-Escaping-Version von + (Pluszeichen) ist %2B.

Verwende + vor einem gängigen Wort, das Google normalerweise verwirft, bevor es Suchergebnisse identifiziert.
Beispiele Nutzereingabe: Star Wars Episode +I
Suchbegriff: q=Star+Wars+Episode+%2BI

Nur Suche nach Links, alle Begriffe [ allinlinks: ]
Beschreibung

Für den allinlinks:-Suchbegriff müssen Dokumente in den Suchergebnissen alle Wörter in der Suchanfrage in URL-Links enthalten. Die Suchanfrage sollte das Format allinlinks: haben, gefolgt von den Wörtern aus Ihrer Suchanfrage.

Wenn deine Suchanfrage den Suchbegriff allinlinks: enthält, prüft Google nur die URL-Links in Dokumenten auf die Wörter in der Suchanfrage. Anderer Text in den Dokumenten, die Dokumenttitel und die URLs der einzelnen Dokumente werden dabei ignoriert. Beachte, dass sich die Dokument-URL von den im Dokument enthaltenen URL-Links unterscheidet.

Die URL-Version von allinlinks: ist allinlinks%3A.
Beispiele Nutzereingabe:allinlinks: Google search
Suchbegriff:q=allinlinks%3A+Google+search

Wortgruppensuche
Beschreibung

Mit dem Suchbegriff „Passende Wortgruppe“ (“) können Sie nach vollständigen Wortgruppen suchen, indem Sie sie in Anführungszeichen setzen oder mit Bindestrichen verbinden.

Die URL-Version von " (Anführungszeichen) ist %22.

Die Suche nach Wortgruppen ist besonders nützlich, wenn Sie nach berühmten Zitaten oder Eigennamen suchen.

Sie können auch den Anfrageparameter as_epq verwenden, um eine Wortgruppensuche zu senden.
Beispiele Nutzereingabe:"Abraham Lincoln"
Suchbegriff: q=%22Abraham+Lincoln%22

Nur Textsuche, alle Begriffe [allintext:]
Beschreibung

Für den allintext:-Suchbegriff muss jedes Dokument in den Suchergebnissen alle Wörter in der Suchanfrage im Textbereich des Dokuments enthalten. Die Abfrage sollte das Format allintext: haben, gefolgt von den Wörtern in Ihrer Suchanfrage.

Wenn Ihre Suchanfrage den Suchbegriff allintext: enthält, prüft Google nur den Text der Dokumente auf die Wörter in der Suchanfrage. Links in diesen Dokumenten, Dokumenttitel und Dokument-URLs werden dabei ignoriert.

Die URL-Version von allintext: ist allintext%3A.
Beispiele In diesem Beispiel wird angegeben, dass die Wörter „Google“ und „Suche“ im Text aller Dokumente in den Suchergebnissen enthalten sein müssen:
Nutzereingabe:allintext:Google search
Suchbegriff:q=allintext%3AGoogle+search

Titelsuche, Einzelbegriff [intitle:]
Beschreibung

Der Abfragebegriff intitle: beschränkt Suchergebnisse auf Dokumente, die ein bestimmtes Wort im Dokumenttitel enthalten. Die Suchanfrage sollte das Format intitle:WORD haben. Zwischen dem Suchbegriff intitle: und dem folgenden Wort darf kein Leerzeichen stehen.

Hinweis: Sie können mehr als ein Wort angeben, das im Dokumenttitel enthalten sein muss. Dazu stellen Sie den Suchbegriff intitle: vor jedes Wort. Sie können auch den Suchbegriff allintitle: verwenden, um anzugeben, dass alle Suchbegriffe in den Titeln der Dokumente, die sich in den Suchergebnissen befinden, enthalten sein müssen.

Die URL-Version von intitle: ist intitle%3A.
Beispiele

In diesem Beispiel wird angegeben, dass das Wort „Google“ in den Titeln aller Dokumente in den Suchergebnissen enthalten sein muss und das Wort „Suche“ an beliebiger Stelle im Titel, in den URLs, Links oder im Text dieser Dokumente enthalten sein muss:
Nutzereingabe:intitle:Google search
Suchbegriff:q=intitle%3AGoogle+search

Titelsuche, alle Begriffe [allintitle:]
Beschreibung

Der Abfragebegriff allintitle: beschränkt Suchergebnisse auf Dokumente, die alle Suchbegriffe im Dokumenttitel enthalten. Wenn du den Suchbegriff allintitle: verwenden möchtest, füge am Anfang der Suchanfrage „allintitle:“ ein.

Hinweis:Wenn du allintitle: an den Anfang einer Suchanfrage setzt, entspricht dies der Eingabe von intitle: vor jedem Wort in der Suchanfrage.

Die URL-Escaping-Version von allintitle: ist allintitle%3A.
Beispiele

In diesem Beispiel wird angegeben, dass die Wörter „Google“ und „Suche“ in den Titeln der Dokumente in den Suchergebnissen enthalten sein müssen:
Nutzereingabe: allintitle: Google search
Suchbegriff: q=allintitle%3A+Google+search

URL-Suche, einzelner Begriff [inurl:]
Beschreibung

Der Abfragebegriff inurl: beschränkt Suchergebnisse auf Dokumente, die ein bestimmtes Wort in der Dokument-URL enthalten. Die Suchanfrage muss das Format inurl:WORD haben. Zwischen dem Suchbegriff inurl: und dem folgenden Wort darf kein Leerzeichen stehen.

Der inurl:-Suchbegriff ignoriert Satzzeichen und verwendet nur das erste Wort nach dem inurl:-Operator. Sie können mehr als ein Wort angeben, das in der Dokument-URL enthalten sein muss, indem Sie den Suchbegriff inurl: vor jedes Wort setzen. Sie können auch den Suchbegriff allinurl: verwenden, um anzugeben, dass alle Suchbegriffe in den URLs der Dokumente enthalten sein müssen, die sich in den Suchergebnissen befinden.

Die URL-Version von inurl: ist inurl%3A.
Beispiele

In diesem Beispiel wird angegeben, dass das Wort „Google“ in den URLs aller Dokumente in den Suchergebnissen enthalten sein muss und das Wort „Suche“ an beliebiger Stelle im Titel, in den URLs, Links oder im Text dieser Dokumente enthalten sein muss:
Nutzereingabe: inurl:Google search
Suchbegriff: q=inurl%3AGoogle+search

URL-Suche, alle Begriffe [allinurl:]
Beschreibung

Der Abfragebegriff allinurl: beschränkt Suchergebnisse auf Dokumente, die alle Suchbegriffe in der Dokument-URL enthalten. Wenn du den allinurl:-Suchbegriff verwenden möchtest, füge allinurl: an den Anfang der Suchanfrage ein.

Der allinurl:-Suchbegriff ignoriert Zeichensetzung und funktioniert daher nur bei Wörtern, nicht bei URL-Komponenten. Beispielsweise beschränkt allinurl: uk/scotland die Ergebnisse auf Dokumente, die in ihren URLs die Wörter „uk“ und „scotland“ enthalten. Diese beiden Wörter müssen jedoch nicht in einer bestimmten Reihenfolge stehen oder durch einen Schrägstrich getrennt sein.

Die URL-Version von allinurl: ist allinurl%3A.
Beispiele

In diesem Beispiel wird angegeben, dass die Wörter „Google“ und „Suche“ in den URLs aller Dokumente in den Suchergebnissen enthalten sein müssen:
Nutzereingabe: allinurl: Google search
Suchbegriff: q=allinurl%3A+Google+search


Informationen zu Webdokumenten [info:]
Beschreibung

Mit dem Abfragebegriff info: werden allgemeine Informationen zu einer URL abgerufen, sofern diese URL im Suchindex von Google enthalten ist. Die Suchanfrage sollte das Format info:URL haben. Zwischen dem Suchbegriff info: und der URL darf kein Leerzeichen stehen.

Die URL-Escaping-Version von info: ist info%3A.

Hinweis: Sie können keine anderen Suchbegriffe angeben, wenn Sie info: verwenden.
Beispiele Nutzereingabe: info:www.google.com
Suchbegriff: q=info%3Awww.google.com

Beispielabfragen für Bilder

Die folgenden Beispiele zeigen einige Bild-HTTP-Anfragen, um die Verwendung verschiedener Abfrageparameter zu veranschaulichen. Definitionen für die verschiedenen Suchparameter finden Sie in diesem Dokument in den Abschnitten zu den Definitionen der Suchparameter für Bilder.

In dieser Anfrage werden die ersten fünf Ergebnisse (start=0&num=5) für den Suchbegriff „Affe“ (q=monkey) mit dem Dateityp „.png“ angefordert. Schließlich gibt die Abfrage Werte für die Parameter client, output und cx an, die alle drei erforderlich sind.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Suchparameter für die Bildersuche

as_filetype
Beschreibung

Optional: Gibt Bilder eines angegebenen Typs zurück. Zulässige Werte sind: bmp, gif, png, jpg und svg.
Beispiele q=google&as_filetype=png

imgsz
Beschreibung

Optional: Gibt Bilder einer bestimmten Größe zurück, wobei die Größe einer der folgenden Werte sein kann:

  • icon (klein)
  • small|medium|large|xlarge (mittel)
  • xxlarge (groß)
  • huge (extragroß)

Beispiele q=google&as_filetype=png&imgsz=icon

imgtype
Beschreibung

Optional: Gibt Bilder eines Typs zurück. Dabei kann es sich um einen der folgenden Typen handeln:

  • clipart (Clipart)
  • face (Gesicht)
  • lineart (linear)
  • news (Nachrichten)
  • photo (Foto)
Beispiele q=google&as_filetype=png&imgtype=photo

imgc
Beschreibung

Optional: Gibt Schwarz-Weiß-, Graustufen- oder Farbbilder zurück:

  • mono (Schwarz-Weiß)
  • gray (Graustufen)
  • color (Farbe)
Beispiele q=google&as_filetype=png&imgc=gray

imgcolor
Beschreibung

Optional: Gibt Bilder einer bestimmten dominanten Farbe zurück:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Beispiele q=google&as_filetype=png&imgcolor=yellow

as_rights
Beschreibung

Optional: Filter sind lizenzbasiert. Unterstützte Werte sind:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
Beispiele q=cats&as_filetype=png&as_rights=cc_attribute

Anfragelimits

In der folgenden Tabelle sind die Einschränkungen für die Suchanfragen aufgeführt, die du an Google sendest:

Komponente Limit Kommentar
Länge der Suchanfrage 2.048 Byte  
Anzahl der Suchbegriffe 10 enthält Begriffe in den folgenden Parametern: q, as_epq, as_eq, as_lq, as_oq, as_q
Anzahl der Ergebnisse 20 Wenn Sie den Parameter num auf eine Zahl größer als 20 setzen, werden nur 20 Ergebnisse zurückgegeben. Um mehr Ergebnisse zu erhalten, müssten Sie mehrere Anfragen senden und den Wert des Parameters start bei jeder Anfrage erhöhen.

Abfrage und Ergebnispräsentation internationalisieren

Mit Google WebSearch können Sie nach Dokumenten in mehreren Sprachen suchen. Sie können die Zeichencodierung angeben, die zum Interpretieren Ihrer HTTP-Anfrage und zum Codieren Ihrer XML-Antwort verwendet werden soll. Verwenden Sie dazu die Suchparameter ie und oe. Sie können die Ergebnisse auch so filtern, dass nur Dokumente in bestimmten Sprachen enthalten sind.

In den folgenden Abschnitten werden Probleme bei der Suche in mehreren Sprachen erläutert:

Zeichencodierung

Server senden Daten wie Webseiten als Folge codierter Byte an User-Agents wie Browser. Der User-Agent decodiert dann die Byte in eine Zeichenfolge. Wenn Sie Anfragen an den WebSearch-Dienst senden, können Sie die Codierungsschemas sowohl für Ihre Suchanfrage als auch für die XML-Antwort angeben, die Sie erhalten.

Mit dem Anfrageparameter ie können Sie den Codierungsmechanismus für die Zeichen in Ihrer HTTP-Anfrage angeben. Mit dem Parameter oe können Sie auch das Codierungsschema angeben, das Google zum Codieren Ihrer XML-Antwort verwenden soll. Wenn Sie ein anderes Codierungsschema als ISO-8859-1 (oder latin1) verwenden, müssen Sie die richtigen Werte für die Parameter ie und oe angeben.

Hinweis:Wenn Sie Suchfunktionen für mehrere Sprachen bereitstellen, empfehlen wir die Verwendung des Codierungswerts utf8 (UTF-8) für die Parameter ie und oe.

Im Anhang Zeichencodierungsschemata finden Sie eine vollständige Liste der Werte, die Sie für die Parameter ie und oe verwenden können.

Allgemeine Informationen zur Zeichencodierung finden Sie unter http://www.w3.org/TR/REC-html40/charset.html.

Sprachen der Benutzeroberfläche

Mit dem Anfrageparameter hl können Sie die Sprache Ihrer grafischen Benutzeroberfläche angeben. Der Parameterwert hl kann sich auf XML-Suchergebnisse auswirken, insbesondere bei internationalen Abfragen, wenn die Sprachbeschränkung (mithilfe des Parameters lr) nicht explizit angegeben wurde. In diesem Fall können Suchergebnisse durch den Parameter hl in derselben Sprache wie die Eingabesprache des Nutzers angezeigt werden.

Wir empfehlen, den hl-Parameter in den Suchergebnissen explizit festzulegen, damit Google für jede Suchanfrage die qualitativ hochwertigsten Suchergebnisse auswählt.

Eine vollständige Liste der gültigen Werte für den Parameter hl finden Sie im Abschnitt Unterstützte Oberflächensprachen.

Nach Dokumenten in bestimmten Sprachen suchen

Mit dem Anfrageparameter lr können Sie die Suchergebnisse auf Dokumente beschränken, die in einer bestimmten Sprache oder einer Gruppe von Sprachen geschrieben sind.

Der Parameter lr unterstützt Boolesche Operatoren, mit denen Sie mehrere Sprachen angeben können, die in den Suchergebnissen berücksichtigt oder davon ausgeschlossen werden sollen.

Die folgenden Beispiele zeigen, wie Sie Boolesche Operatoren verwenden können, um Dokumente in verschiedenen Sprachen anzufordern.

Für japanische Dokumente:

lr=lang_jp

Für Dokumente in italienischer oder deutscher Sprache:

lr=lang_it|lang_de

Für Dokumente, die nicht auf Ungarisch oder Tschechisch verfasst sind:

lr=(-lang_hu).(-lang_cs)

Im Abschnitt Werte für die Spracherfassung finden Sie eine vollständige Liste der möglichen Werte für den Parameter lr und die Abschnitte Boolesche Operatoren. Dort finden Sie eine umfassende Beschreibung der Verwendung dieser Operatoren.

Vereinfachtes Chinesisch und traditionelles Chinesisch sind zwei Schriftvarianten des Chinesischs. Dasselbe Konzept kann in jeder Variante unterschiedlich geschrieben werden. Bei einer Suchanfrage in einer der Varianten kann der Google WebSearch-Dienst Ergebnisse zurückgeben, die Seiten in beiden Varianten enthalten.

So verwenden Sie dieses Feature:

  1. Setzen Sie den Anfrageparameter c2coff auf 0
    und
  2. Führen Sie einen der folgenden Schritte aus:
    • Legen Sie nicht den Anfrageparameter lr fest
      oder
    • Setzen Sie den Anfrageparameter lr auf lr=lang_zh-TW|lang_zh-CN.

Das folgende Beispiel zeigt die Abfrageparameter, die Sie in eine Ergebnisanfrage in vereinfachtem und traditionellem Chinesisch einschließen würden. Zusätzliche erforderliche Informationen wie der client sind im Beispiel nicht enthalten.

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Ergebnisse filtern

Mit Google WebSearch haben Sie mehrere Möglichkeiten, Ihre Suchergebnisse zu filtern:

Automatisches Filtern von Suchergebnissen

Im Rahmen unserer Bemühungen, die bestmöglichen Suchergebnisse zu liefern, verwendet Google zwei Verfahren, um allgemein als unerwünscht geltende Suchergebnisse automatisch zu filtern:

  • Duplizierte Inhalte – Wenn mehrere Dokumente dieselben Informationen enthalten, wird nur das relevanteste Dokument dieses Satzes in die Suchergebnisse einbezogen.

  • Host-Crowding: Wenn viele Suchergebnisse von derselben Website vorliegen, werden unter Umständen nicht alle Ergebnisse von dieser Website angezeigt oder die Ergebnisse werden im Ranking weiter unten
    angezeigt, als dies sonst der Fall gewesen wäre.

Wir empfehlen, diese Filter für typische Suchanfragen aktiviert zu lassen, da sie die Qualität der meisten Suchergebnisse erheblich verbessern. Sie können diese automatischen Filter jedoch umgehen, indem Sie den Abfrageparameter filter in der Suchanfrage auf 0 setzen.

Nach Sprache und Land filtern

Der Google WebSearch-Dienst gibt Ergebnisse aus einem Masterindex aller Webdokumente zurück. Der Masterindex enthält untergeordnete Sammlungen von Dokumenten, die nach bestimmten Attributen gruppiert sind, darunter Sprache und Ursprungsland.

Sie können die Anfrageparameter lr und cr verwenden, um Suchergebnisse auf untergeordnete Sammlungen von Dokumenten zu beschränken, die in bestimmten Sprachen geschrieben sind oder aus bestimmten Ländern stammen.

Die Sprache eines Dokuments wird mit Google WebSearch anhand folgender Daten bestimmt:

  • die Top-Level-Domain (TLD) der Dokument-URL
  • Meta-Tags für die Sprache innerhalb des Dokuments
  • die im Textkörper des Dokuments verwendete Hauptsprache


Weitere Informationen zum Einschränken von Ergebnissen nach Sprache finden Sie auch in der Definition des Parameters lr, im Abschnitt zum Suchen nach Dokumenten in bestimmten Sprachen und in den Werten für die Spracherfassung, die als Werte für den Parameter lr verwendet werden können.

Google WebSearch ermittelt das Land eines Dokuments durch die Analyse:

  • die Top-Level-Domain (TLD) der Dokument-URL
  • den geografischen Standort der IP-Adresse des Webservers

Weitere Informationen zum Einschränken von Ergebnissen nach Herkunftsland finden Sie in der Definition des Parameters cr und der Werte für die Ländersammlung, die als Werte für den Parameter cr verwendet werden können.

Hinweis:Sie können Sprach- und Länderwerte kombinieren, um Ihre Suchergebnisse anzupassen. Sie können beispielsweise Dokumente in französischer Sprache anfordern, die aus Frankreich oder Kanada stammen, oder Dokumente aus den Niederlanden, die nicht auf Englisch verfasst sind. Die Parameter lr und cr unterstützen beide Boolesche Operatoren.

Nicht jugendfreie Inhalte mit SafeSearch filtern

Viele Google-Kunden möchten keine Suchergebnisse für Websites mit Inhalten nur für Erwachsene anzeigen. Mit unserem SafeSearch-Filter kannst du Suchergebnisse mit Inhalten nur für Erwachsene herausfiltern und ausschließen. Die Filter von Google nutzen eigene Technologien, um Keywords, Wortgruppen und URLs zu überprüfen. Zwar sind keine Filter zu 100 % genau, SafeSearch entfernt jedoch den Großteil der Inhalte nur für Erwachsene aus deinen Suchergebnissen.

Google ist bestrebt, SafeSearch so aktuell und umfassend wie möglich zu gestalten. Dazu werden fortlaufend das Web gecrawlt und Aktualisierungen aus Nutzervorschlägen übernommen.

SafeSearch ist in den folgenden Sprachen verfügbar:

Niederländisch
Englisch
Französisch
Deutsch 		Italienisch
Portugiesisch (Brasilien)
Spanisch
Chinesisch (traditionell)

Mit dem Abfrageparameter safe können Sie einstellen, inwieweit Google Ihre Ergebnisse für Inhalte nur für Erwachsene filtert. In der folgenden Tabelle werden die SafeSearch-Einstellungen von Google und ihre Auswirkungen auf die Suchergebnisse erläutert:

SafeSearch-Ebene Beschreibung
hoch Aktiviert eine strengere Version von SafeSearch.
medium Blockiert Webseiten, die Pornografie und andere explizite sexuelle Inhalte enthalten.
deaktiviert Inhalte nur für Erwachsene werden nicht aus den Suchergebnissen herausgefiltert.

* Die SafeSearch-Standardeinstellung ist deaktiviert.

Wenn Sie SafeSearch aktiviert haben und in Ihren Ergebnissen Websites mit anstößigen Inhalten finden, senden Sie eine E-Mail mit der URL der Website an safesearch@google.com. Wir werden die Website dann untersuchen.

XML-Ergebnisse

DTD mit Google XML-Ergebnissen

Google verwendet dieselbe DTD, um das XML-Format für alle Arten von Suchergebnissen zu beschreiben. Viele Tags und Attribute gelten für alle Suchtypen. Einige Tags gelten jedoch nur für bestimmte Suchtypen. Daher können die Definitionen in der DTD weniger restriktiv sein als die Definitionen in diesem Dokument.

In diesem Dokument werden die Aspekte der DTD beschrieben, die für WebSearch relevant sind. Wenn Sie sich die DTD ansehen und an WebSearch arbeiten, können Sie Tags und Attribute bedenkenlos ignorieren, die hier nicht dokumentiert sind. Wenn sich die Definition zwischen der DTD und der Dokumentation unterscheidet, ist dies in diesem Dokument angegeben.

Google kann XML-Ergebnisse entweder mit oder ohne Verweis auf die neueste DTD zurückgeben. Das DTD ist ein Leitfaden, der Suchadministratoren und XML-Parser dabei unterstützt, die XML-Ergebnisse von Google zu verstehen. Da sich die XML-Grammatik von Google von Zeit zu Zeit ändern kann, sollten Sie Ihren Parser nicht für die Verwendung der DTD zur Validierung jedes XML-Ergebnisses konfigurieren.

Außerdem sollten Sie Ihren XML-Parser nicht so konfigurieren, dass er die DTD bei jeder Übermittlung einer Suchanfrage abruft. Google aktualisiert die DTD nur selten und diese Anfragen verursachen unnötige Verzögerungs- und Bandbreitenanforderungen.

Google empfiehlt für XML-Ergebnisse die Verwendung des Ausgabeformats xml_no_dtd. Wenn Sie in Ihrer Suchanfrage das Ausgabeformat xml output angeben, besteht der einzige Unterschied darin, dass folgende Zeile in die XML-Ergebnisse aufgenommen wird:

<!DOCTYPE GSP SYSTEM "google.dtd">

Die neueste DTD finden Sie unter http://www.google.com/google.dtd.

Bitte beachte, dass zu diesem Zeitpunkt möglicherweise nicht alle Funktionen der DTD verfügbar oder unterstützt werden.

Informationen zur XML-Antwort

  • Alle Elementwerte sind gültigen HTML-Code und können angezeigt werden, sofern in den XML-Tag-Definitionen nichts anderes angegeben ist.
  • Einige Elementwerte sind URLs, die HTML-codiert werden müssen, bevor sie angezeigt werden.
  • Der XML-Parser sollte nicht dokumentierte Attribute und Tags ignorieren. So kann Ihre Anwendung ohne Änderungen weiterarbeiten, wenn Google der XML-Ausgabe weitere Funktionen hinzufügt.
  • Bestimmte Zeichen müssen mit Escapezeichen versehen werden, wenn sie als Werte in XML-Tags enthalten sind. Der XML-Prozessor sollte diese Entitäten wieder in die entsprechenden Zeichen konvertieren. Wenn Sie Entitäten nicht ordnungsgemäß konvertieren, kann der Browser beispielsweise das &-Zeichen als "&amp;" rendern. Im XML-Standard werden diese Zeichen dokumentiert. Sie werden in der folgenden Tabelle wiedergegeben:

    Figur Formulare mit Escape-Zeichen Entität Zeichencode
    Kaufmännisches Und-Zeichen & &amp; -
    Einfaches Anführungszeichen ' &apos; &#39;
    Doppeltes Anführungszeichen " &quot; 34;
    Größer-als-Zeichen > &gt; &#62;
    Kleiner-als-Zeichen < &lt; -

XML-Ergebnisse für reguläre und erweiterte Suchanfragen

Normale/erweiterte Suche: Beispielabfrage und XML-Ergebnis

In dieser Beispiel-WebSearch-Anfrage werden zehn Ergebnisse (num=10) zum Suchbegriff „socer“ (q=socer) angefordert, der in diesem Beispiel absichtlich falsch geschrieben wurde.

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i

Diese Anfrage liefert das unten stehende XML-Ergebnis. Das XML-Ergebnis enthält mehrere Kommentare, die angeben, wo bestimmte, nicht im Ergebnis enthaltene Tags erscheinen würden.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

Normale/erweiterte Suche: XML-Tags

XML-Antworten auf reguläre und erweiterte Suchanfragen verwenden beide denselben Satz von XML-Tags. Diese XML-Tags werden im XML-Beispiel oben dargestellt und in den folgenden Tabellen erläutert.

Die unten aufgeführten XML-Tags sind alphabetisch nach Tag-Namen aufgeführt. Jede Tag-Definition enthält eine Beschreibung des Tags und ein Beispiel, das zeigt, wie das Tag in einem XML-Ergebnis aussehen würde und welches Format des Inhalts des Tags vorliegt. Wenn das Tag ein Subtag eines anderen XML-Tags ist oder wenn das Tag eigene Untertags oder Attribute hat, werden diese Informationen auch in der Definitionstabelle des Tags bereitgestellt.

In den Definitionen unten können neben einigen Subtags bestimmte Symbole angezeigt werden. Diese Symbole haben folgende Bedeutungen:

? = optionales Subtag
* = keine oder mehrere Instanzen des Subtags
+ = eine oder mehrere Instanzen des Subtags
V B C D F G I M N P F R S T U X

anchor_text
Definition

Das Tag <anchor_text> gibt den Text an, der Nutzern angezeigt werden soll, um ein mit einem Suchergebnis verknüpftes Suchlabel zu identifizieren. Da Suchfilter-Labels nicht alphanumerische Zeichen durch Unterstriche ersetzen, sollten Sie den Wert des Tags <label> in Ihrer Benutzeroberfläche nicht anzeigen. Stattdessen sollten Sie den Wert des Tags <anchor_text> anzeigen.

Beispiel <anchor_text>Golfplätze</anchor_text>
Subtag von FacetItem
Inhaltsformat Text

BLOCKIEREN
Definition

Dieses Tag schließt den Inhalt eines Blocks in einer Textzeile eines Werbeergebnisses ein. Jeder Block hat die Untertags T, U und L. Ein nicht leeres T-Tag gibt an, dass der Block Text enthält. Nicht leere U- und L-Tags geben an, dass der Block einen Link enthält (mit der URL im U-Subtag und Ankertext im L-Subtag).
Subtags T, U, L
Subtag von BODY_LINE
Inhaltsformat Leer

BODY_LINE
Definition

Dieses Tag schließt den Inhalt einer Zeile im Text des beworbenen Ergebnisses ein. Jede Textzeile besteht aus mehreren BLOCK-Tags, die entweder etwas Text oder einen Link mit URL und Ankertext enthalten.
Subtags BLOCKIEREN*
Subtag von SL_MAIN
Inhaltsformat Leer

C
Definition

Das <C>-Tag gibt an, dass der WebSearch-Dienst eine im Cache gespeicherte Version dieser Suchergebnis-URL abrufen kann. Im Cache gespeicherte Seiten lassen sich nicht über die XML API abrufen. Sie haben aber die Möglichkeit, Nutzer für diese Inhalte an www.google.com weiterzuleiten.
Attributes
Name Format Beschreibung
SZ Text (Ganzzahl + "k") Gibt die Größe der im Cache gespeicherten Version des Suchergebnisses in Kilobyte ("k") an.
Kundennummer Text Kennzeichnet ein Dokument im Cache von Google. Wenn Sie das Dokument aus dem Cache abrufen möchten, senden Sie einen Suchbegriff, der so aufgebaut ist:
cache:CIDtext:maskURL

Die maskierte URL ist im UE-Tag verfügbar.
Beispiel <C SZ="6k" CID="kvOXK_cYSSgJ" />
Subtag von HAS
Inhaltsformat Leer

C2C
Definition Das <C2C>-Tag gibt an, dass sich das Ergebnis auf eine Seite in traditionellem Chinesisch bezieht. Dieses Tag wird nur angezeigt, wenn Chinesisch (vereinfacht und traditionell) aktiviert ist. Weitere Informationen zum Aktivieren und Deaktivieren dieser Funktion finden Sie in der Definition des Abfrageparameters c2coff.
Inhaltsformat Text

Kontext
Definition

Das Tag <Context> enthält eine Liste von Labels zur Optimierung, die mit einer Reihe von Suchergebnissen verknüpft sind.
Beispiel <Context>
Subtags title, Facet+
Inhaltsformat Container

CRAWLDATE
Definition

Das <CRAWLDATE>-Tag gibt das Datum an, an dem die Seite zuletzt gecrawlt wurde. CRAWLDATE wird nicht für jede Suchergebnisseite zurückgegeben.
Beispiel <CRAWLDATE>21. Mai 2005</CRAWLDATE>
Subtag von R
Inhaltsformat Text

DI
Definition

Das <DI>-Tag kapselt Informationen zur Open Directory Project-(ODP)-Kategorie für ein einzelnes Suchergebnis.
Beispiel <DI>
Subtags DT?, DS?
Subtag von HAS
Inhaltsformat Leer

DS
Definition

Das Tag <DS> liefert die Zusammenfassung für eine einzelne Kategorie im ODP-Verzeichnis.
Beispiel <DS>Posten Sie Ihren Lebenslauf für &lt;b&gt;Fußball&lt;/b&gt; direkt im Internet.</DS>
Subtag von DI
Inhaltsformat Text (kann HTML enthalten)

Gerätebaum
Definition

Das Tag <DT> liefert den Titel für eine einzelne Kategorie, die im ODP-Verzeichnis aufgeführt ist.
Beispiel <DT>SoccerConnection.net</DT>
Subtag von DI
Inhaltsformat Text (kann HTML enthalten)

Attribut
Definition

Das <Facet>-Tag enthält eine logische Gruppierung von <FacetItem>-Tags. Sie können diese Gruppierungen mit dem XML-Spezifikationsformat der Programmable Search Engine erstellen. Wenn Sie diese Gruppierungen nicht erstellen, enthält das Tag results_xml_tag_Context><Context> bis zu vier <Facet>-Tags. Die Elemente in jedem <Facet>-Tag werden zu Anzeigezwecken gruppiert, haben aber möglicherweise keine logische Beziehung.
Beispiel <Facet>
Subtags FacetItem+, title+
Subtag von Kontext
Inhaltsformat Container

FacetItem
Definition

Das Tag <FacetItem> enthält Informationen zu einem Suchfilter-Label, das mit einer Reihe von Suchergebnissen verknüpft ist.
Beispiel <FacetItem>
Subtags label, anchor_text+
Subtag von Attribut
Inhaltsformat FacetItem

FI
Definition Das Tag <FI> dient als Flag, das angibt, ob für die Suche eine Dokumentfilterung durchgeführt wurde. Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie im Abschnitt Automatische Filterung in diesem Dokument.
Beispiel <FI />
Subtag von RES
Inhaltsformat Leer

Gesponserte Werbung in Gmail
Definition

Das <GSP>-Tag enthält alle Daten, die in den XML-Suchergebnissen von Google zurückgegeben werden. „GSP“ ist eine Abkürzung für „Google Search Protocol“.
Attributes
Name Format Beschreibung
VER Text (Ganzzahl) Das VER-Attribut gibt die Version der Ausgabe der Suchergebnisse an. Die aktuelle Ausgabeversion ist „3.2“.
Beispiel <GSP VER="3.2">
Subtags PARAM+, Q, RES?, TM
Inhaltsformat Leer

HAS
Definition Das <HAS>-Tag enthält Informationen zu speziellen Suchanfrageparametern, die für eine bestimmte URL unterstützt werden.

Hinweis:Die Definition von <HAS> für WebSearch ist restriktiver als in der DTD.

Subtags DI?, L?, C?, RT?
Subtag von R

ISURL
Definition Google gibt das <ISURL>-Tag zurück, wenn die zugehörige Suchanfrage eine URL ist.
Subtag von GSP
Inhaltsformat Leer

L
Definition Wenn das <L>-Tag vorhanden ist, kann der WebSearch-Dienst andere Websites finden, die Links zu dieser Suchergebnis-URL enthalten. Um solche Websites zu finden, würden Sie den speziellen Suchbegriff link: verwenden.
Subtag von HAS
Inhaltsformat Leer

Label
Definition

Das <label>-Tag gibt ein Label für den Suchfilter an, mit dem Sie die Suchergebnisse filtern können. Wenn Sie ein Suchfilter-Label verwenden möchten, fügen Sie dem Wert des Parameters q in Ihrer HTTP-Anfrage an Google den String more:[[label tag value]] hinzu, wie im folgenden Beispiel gezeigt. Beachten Sie, dass dieser Wert URL-Escaping sein muss, bevor Sie die Anfrage an Google senden.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

Hinweis:Das <label>-Tag ist nicht mit dem <Label>-Tag identisch, mit dem ein Suchfilter-Label identifiziert wird, das mit einer bestimmten URL in Ihren Suchergebnissen verknüpft ist.
Beispiel <label>golfplätze</label>
Subtag von FacetItem
Inhaltsformat Text

lang
Definition

Das Tag <LANG> enthält die bestmögliche Vermutung über die Sprache des Suchergebnisses durch Google.
Beispiel <LANG>en</LANG>
Subtag von R
Inhaltsformat Text

M
Definition

Das <M>-Tag gibt die geschätzte Gesamtzahl der Ergebnisse für die Suche an.

Hinweis : Diese Schätzung ist möglicherweise nicht korrekt.

Beispiel <M>16200000</M>
Subtag von RES
Inhaltsformat Text

Neugeborene
Definition

Das <NB>-Tag enthält Navigationsinformationen für den Ergebnissatz, also Links zur nächsten Suchergebnisseite oder zur vorherigen Suchergebnisseite.

Hinweis:Dieses Tag ist nur vorhanden, wenn mehr Ergebnisse verfügbar sind.
Beispiel <NB>
Subtags NU?, Verarbeitungseinheit?
Subtag von RES
Inhaltsformat Leer

NU
Definition

Das <NU>-Tag enthält einen relativen Link zur nächsten Suchergebnisseite.
Beispiel <NU>/search?q=flowers&num=10&hl=de&ie=UTF-8
&output=xml&client=test&start=10</NU>
Subtag von Hinweis
Inhaltsformat Text (relative URL)

PARAM
Definition

Das Tag <PARAM> gibt einen Eingabeparameter an, der in der mit dem XML-Ergebnis verknüpften HTTP-Anfrage gesendet wurde. Informationen zum Parameter sind in den Tag-Attributen „name“, „value“ und „original_value“ enthalten. Für jeden in der HTTP-Anfrage gesendeten Parameter gibt es ein PARAM-Tag.
Attributes
Name Format Beschreibung
name Text Name des Eingabeparameters.
Wert HTML HTML-formatierte Version des Eingabeparameterwerts.
original_value Text Ursprüngliche URL-Escaping-Version des Eingabeparameters.
Beispiel <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Subtag von GSP
Inhaltsformat Komplex

Verarbeitungseinheit
Definition

Das <PU>-Tag stellt einen relativen Link zur vorherigen Suchergebnisseite bereit.
Beispiel <PU>/search?q=blumen&num=10&hl=de&output=xml
&client=test&start=10</PU>
Subtag von Hinweis
Inhaltsformat Text (relative URL)

F
Definition

Das <Q>-Tag gibt die Suchanfrage an, die in der mit dem XML-Ergebnis verknüpften HTTP-Anfrage gesendet wurde.
Beispiel

<Q>pizza</Q>
Subtag von GSP
Inhaltsformat Text

R
Definition

Das <R>-Tag enthält die Details eines einzelnen Suchergebnisses.

Hinweis:Die Definition des <R>-Tags für WebSearch ist restriktiver als in der DTD.

Attributes
Name Format Beschreibung
N Text (Ganzzahl) Gibt den Index (1-basiert) dieses Suchergebnisses an.
MIME Text Gibt den MIME-Typ des Suchergebnisses an.
Subtags U, UE, T?, CRAWLDATE, S?, LANG?, HAS
Subtag von RES

WID
Definition

Das Tag <RES> schließt die Gruppe einzelner Suchergebnisse und Details zu diesen Ergebnissen ein.
Attributes
Name Format Beschreibung
SN Text (Ganzzahl) Gibt den Index (1-basiert) des ersten Suchergebnisses an, das in dieser Ergebnismenge zurückgegeben wird.
DE Text (Ganzzahl) Gibt den Index (1-basiert) des letzten Suchergebnisses an, das in dieser Ergebnismenge zurückgegeben wurde.
Beispiel <RES SN="1" EN="10">
Subtags M, FI?, XT?, NB?, R*
Subtag von GSP
Inhaltsformat Leer

S
Definition

Das <S>-Tag enthält einen Auszug für ein Suchergebnis, in dem Suchbegriffe fett hervorgehoben sind. Der Auszug enthält Zeilenumbrüche für den richtigen Textumbruch.
Beispiel <S>Washington (CNN) -- Ein Gebot zur Beendigung der Einigung im Senat gegen Präsident &lt;b&gt;Bush&#39;s&lt;/b&gt; Gerichtsentscheidungen würde fünf Nominierten zur endgültigen Abstimmung eintreten, wobei die Abstimmung
Subtag von R
Inhaltsformat Text (HTML)

SL_MAIN
Definition

Dieses Tag schließt den Inhalt eines Werbeergebnisses ein. Wird zum Parsen von Angeboten verwendet. Der Ankertext und die URL des Titellinks sind in den Untertags T bzw. U enthalten. Die Zeilen des Textkörpers und der Links sind in BODY_LINE-Subtags enthalten.
Subtags BODY_LINE*, T, U
Subtag von SL_RESULTS
Inhaltsformat Leer

SL_RESULTS
Definition

Container-Tag für beworbene Ergebnisse. Eine davon wird immer dann angezeigt, wenn Sie eine Werbung in Ihren Suchergebnissen haben. Das Subtag SL_MAIN enthält die Hauptergebnisdaten.
Subtags SL_MAIN*
Subtag von R
Inhaltsformat Leer

Rechtschreibung
Definition

Das Tag <Spelling> enthält einen alternativen Rechtschreibvorschlag für die eingereichte Abfrage. Dieses Tag erscheint nur auf der ersten Suchergebnisseite. Rechtschreibvorschläge sind auf Englisch, Chinesisch, Japanisch und Koreanisch verfügbar.

Hinweis: Google gibt nur Rechtschreibvorschläge für Abfragen zurück, bei denen der Wert des Parameters gl in Kleinbuchstaben angegeben ist.
Beispiel <Spelling>
Subtags Vorschlag
Subtag von GSP
Inhaltsformat Leer

Vorschlag
Definition Das Tag <Suggest> enthält einen alternativen Rechtschreibvorschlag für die eingereichte Abfrage. Anhand des Tag-Inhalts kannst du dem Nutzer der Suche eine alternative Schreibweise vorschlagen. Der Wert des Attributs q ist der Rechtschreibvorschlag mit URL-Escaping, den Sie als Abfragebegriff verwenden können.
Attributes
Name Format Beschreibung
q Text Das Attribut q gibt die URL-Escaping-Version des Rechtschreibvorschlags an.
Beispiel <Vorschlag q="Fußball">&lt;b&gt;&lt;i&gt;Fußball&lt;/i&gt;&lt;/b&gt;</Vorschlag>
Subtag von Rechtschreibung
Inhaltsformat Text (HTML)

T
Definition Das <T>-Tag enthält den Titel des Ergebnisses.
Beispiel <T>Amici's East Coast Pizzeria</T>
Subtag von R
Inhaltsformat Text (HTML)

title
Definition

Als untergeordnetes Element von <Context> enthält das <title>-Tag den Namen Ihrer Programmable Search Engine.

Als untergeordnetes Element von <Facet> liefert das <title>-Tag einen Titel für eine Reihe von Attributen.
Beispiel

Als Kind von <Context>: <title>My Search Engine</title>

Als untergeordnetes Element von <Facet>: <title>facet title</title>
Subtag von Kontext, Facette
Inhaltsformat Text

TM
Definition

Das <TM>-Tag gibt die gesamte Serverzeit an, die für die Ausgabe von Suchergebnissen benötigt wird, in Sekunden.
Beispiel <TM>0,100445</TM>
Subtag von GSP
Inhaltsformat Text (Gleitkommazahl)

TT
Definition Das Tag <TT> enthält einen Tipps für die Suche.
Beispiel <TT>&lt;i&gt;Tipp: Bei den meisten Browsern führt das Drücken der Eingabetaste zum gleichen Ergebnis wie das Klicken auf die Suchschaltfläche.&lt;/i&gt;</TT>
Subtag von GSP

U
Definition Das <U>-Tag gibt die URL des Suchergebnisses an.
Beispiel <U>http://www.dominos.com/</U>
Subtag von R
Inhaltsformat Text (Absolute URL)

UD
Definition

Das <UD>-Tag gibt die IDN-codierte URL (International Domain Name) für das Suchergebnis an. Mit diesem Wert können Domains in lokalen Sprachen angezeigt werden. So könnte beispielsweise die IDN-codierte URL http://www.%E8%8A%B1%E4%BA%95.com decodiert und als http://www.花井鮨.com angezeigt werden. Dieses <UD>-Tag wird nur in die Suchergebnisse für Anfragen mit dem Parameter ud aufgenommen.

Hinweis:Dies ist eine Betafunktion.
Beispiel <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
Subtag von R
Inhaltsformat Text (IDN-codierte URL)

UE
Definition Das <UE>-Tag gibt die URL des Suchergebnisses an. Der Wert ist URL-Escaping und eignet sich daher zur Weitergabe als Abfrageparameter in einer URL.
Beispiel <UE>http://www.dominos.com/</UE>
Subtag von R
Inhaltsformat Text (URL-Escaping-URL)

Logo: XT
Definition Das <XT>-Tag gibt an, dass die geschätzte Gesamtzahl der Ergebnisse, wie durch das Tag M angegeben, tatsächlich die genaue Gesamtzahl der Ergebnisse darstellt. Weitere Informationen finden Sie in diesem Dokument im Abschnitt Automatische Filterung.
Beispiel <XT />
Subtag von RES
Inhaltsformat Leer


XML-Ergebnisse für Bildersuchen

Bei dieser Beispielanfrage für ein Bild werden fünf Ergebnisse (num=5) zum Suchbegriff „Affe“ (q=Affe) angefordert. 

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

Diese Anfrage liefert das unten stehende XML-Ergebnis. 


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

Bildersuche: XML-Tags

Die folgende Tabelle zeigt zusätzliche XML-Tags, die in XML-Antworten für Bildersuchanfragen verwendet werden.

In den Definitionen unten können neben einigen Subtags bestimmte Symbole angezeigt werden. Diese Symbole haben folgende Bedeutungen:

? = optionales Subtag
* = keine oder mehrere Instanzen des Subtags
+ = eine oder mehrere Instanzen des Subtags

Logo: RG
Definition

Das <RG>-Tag enthält die Details eines einzelnen Ergebnisses für die Bildersuche.
Attributes
Name Format Beschreibung
N Text (Ganzzahl) Gibt den Index (1-basiert) dieses Suchergebnisses an.
MIME Text Gibt den MIME-Typ des Suchergebnisses an.
Subtag von RES
RU
Definition

Das <RU tag>-Tag enthält Details zu jedem Bildsuchergebnis.
Subtag von R