XML-Schnittstelle zur Suche
Für maximale Flexibilität bei der Einbindung der Suche auf Ihrer Website bieten wir eine XML-Schnittstelle an. Die Implementierung erfordert Programmiertätigkeiten auf Ihrer Website.
Die URL der XML-Schnittstelle ist
Die
Dokumentation der Formularparameter für Suchanfragen
beschreibt die notwendigen und möglichen Parameter.
https://sitesearch.netestate.de/Search/XML/Result
Beispiel für ein XML-Suchergebnis:
<?xml version='1.0' encoding='utf-8'?>
<sitesearch-result>
<error/>
<account>test</account>
<websiteids>1111,1112</websiteids>
<query>test</query>
<count>1</count>
<maxresults>1</maxresults>
<start>1</start>
<end>1</end>
<maxcount>10</maxcount>
<extra>meta_tag1 = 'test'</extra>
<startnext>0</startnext>
<startback>0</startback>
<altquery>testen</altquery>
<results>
<result>
<url>https://www.domain.de/test.html</url>
<utitle>Dies ist ein <b>Test</b></utitle>
<qtitle>Dies ist ein <b>Test</b></qtitle>
<uteaser>Dies ist ein <b>Test</b></uteaser>
<qteaser>Dies ist ein <b>Test</b></qteaser>
<content-type>text/html</content-type>
<language>de</language>
<modified>2008/05/21 02:00:00 GMT+2</modified>
<keywords>Test</keywords>
<description>Dies ist ein Test</description>
<meta name="tag1">test</meta>
</result>
</results>
</sitesearch-result>
Beschreibung der XML-Elemente:
- error
- Tritt ein Fehler auf, so enthält dieses Element eine Fehlermeldung und alle anderen Elemente fehlen.
- account
- Verwendeter Benutzername.
- websiteids
- Durchsuchte Website-IDs.
- query
- Verwendete Suchanfrage.
- count
- Anzahl der Treffer.
- maxresults
- Anzahl der Treffer, die wirklich geliefert werden (maximal 500).
- start
- Nummer des ersten Treffers (beginnend bei 1).
- end
- Nummer des letzten Treffers (beginnend bei 1).
- maxcount
- Angeforderte Anzahl von Treffern.
- extra
- Zusatzbedingungen.
- startnext
- Startparameter für die nächste Trefferseite (0 wenn keine weiteren Seiten folgen).
- startback
- Startparameter für die vorausgehende Trefferseite (0 wenn keine weiteren Seiten vorausgehen).
- altquery
- Vorschlag für alternativen Suchbegriff.
- results
- Ergebnisse.
- result
- Einzelnes Ergebnis.
- url
- URL des Treffers.
- utitle
- Titel des Treffers. Verwendete Suchworte sind mit <b> markiert.
- qtitle
- Wie utitle - aber für die Ausgabe als HTML konvertiert.
- uteaser
- Auszug aus dem Dokument. Verwendete Suchworte sind mit <b> markiert.
- qteaser
- Wie uteaser - aber für die Ausgabe als HTML konvertiert.
- content-type
- Typ des Dokuments (Aus HTTP-Header 'Content-Type').
- language
- Sprache des Dokuments (Aus Meta-Tag 'language' bzw. 'content-language').
- modified (Optional)
- Änderungszeitpunkt des Dokuments (Aus HTTP-Header bzw. Meta-Tag 'Last-Modified' oder Meta Tag 'date'). Entfällt falls undefiniert.
- keywords
- Meta-Tag 'keywords' aus HTML-Dokument.
- description
- Meta-Tag 'description' aus HTML-Dokument.
- meta (Optional)
- Benutzerdefinierte Meta-Tags.