getStaticOviTrend

Gibt den statischen OVI-Verlauf einer Domain zurück.

Route	/keywords/getStaticOviTrend[/:key[/:urlpattern[/:sengine[/:format[/:limit[/:skip[/:date]]]]]]]
Erforderliche Parameter	urlpattern sengine
Optionale Parameter	format limit (max:1000) skip date
Rückgabewerte	date staticOvi
Querschnittverbindungen	getSearchEngines() – über diese Funktion können Sie die benötigte Suchmaschine finden
Hinweise	sengine – Es werden ausschließlich die Suchmaschinen der wöchentlich gecrawlten Suchmaschinen akzeptiert. urlpattern – Sie können entweder eine Domain übergeben, oder eine vollständige URL (z.B. Unterseite einer Domain), zu der Sie einen OVI bekommen würden. Limit: Das maximale Limit ist 1000. Um mehr Ergebnisse zu erhalten, benutzen Sie den Parameter Skip. resultCount – Enthält die Anzahl des Ergebnisses ohne Filter. Wird z.B. bei der Paginierung benötigt.

Parameter

Bezeichnung	Beschreibung	Wertebereich	Standardwert
urlpattern	Enthält einen qualifizierten Domainnamen oder eine URL.	(www.|*)?(A-Z|a-z|0-9)+. (a-z|*)+	–
sengine	Enthält eine von Xovi gecrawlte Suchmaschine.	siehe getSearchengines()	–
limit	Legt fest, wie viele Ergebniszeilen zurückgegeben werden sollen. (max:1000)	0-1000	100
skip	Legt fest, wie viele Seiten des Ergebnisarrays übersprungen werden sollen. Eine Seite entspricht dem Wert von limit.	(0-9)+	0
format	Legt fest in welchem Format das Ergebnis zurückgeliefert werden soll.	json|xml	json
date	Enthält ein Datum.	YYYY-MM-DD	letztes crawldatum

Rückgabewerte

Bezeichnung	Beschreibung	Wertebereich
date	Zeigt das Datum an, an dem der dazugehörende OVI gemessen wurde	Datum: YYYY-MM-DD
staticOvi	Enthält den statischen OVI einer Domain zu einem bestimmten Zeitpunkt.	(0-9)+.(0-9)+

Meldungen

Nachricht	Beschreibung
maximum limit exeeded	Das maximale Limit wurde überschritten.
no permission	Dieser Schlüssel hat kein Zugriff auf diese Funktion.
internal error	Ein interner Fehler ist aufgetreten.
param missing	Ein erforderlicher Parameter wurde nicht übergeben.
param invalid	Der Wert eines übergebenen Parameters ist nicht gültig.
result empty	Die Bearbeitung der Anfrage war erfolgreich, aber das Ergebnis ist leer.
cost error	Der aktuelle Kreditumfang reicht nicht aus, um die Anfrage zu bearbeiten.
0k.	Die Bearbeitung der Anfrage war erfolgreich.

Beispielcode

$root = 'https://suite.xovi.net/api/';
$arrayParams = array(
    'service' => 'keywords',
    'method'  => 'getStaticOviTrend',
    'key'     => 'myPersonalKey',
    'urlpattern' => urlencode(urlencode('*.zalando.de/*')),
    'sengine' => 'google.de',
    'format'  => 'json',
    'limit'   => 3,
);
$GETparams = implode('/', $arrayParams);

$requestURL = $root.$GETparams;

if (!function_exists('curl_init')) die('cURL not available');

$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_URL, $requestURL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Download the given URL, and return output
$output = curl_exec($ch);

// Close the cURL resource, and free system resources
curl_close($ch);

echo $output;

Beispielergebnisse

JSON

{
    "apiErrorCode":0,
    "apiErrorMessage":"0k.",
    "apiResult":[{
        "date":"2013-02-11",
        "staticOvi":5995.01
    },
    {
        "date":"2013-02-18",
        "staticOvi":5859.46
    },
    {
        "date":"2013-02-25",
        "staticOvi":5626.82
    }]
}

XML

<?xml version="1.0"?>
<result>
    <apiErrorCode>0</apiErrorCode>
    <apiErrorMessage>0k.</apiErrorMessage>
    <apiResult>
        <staticovitrends>
            <staticovitrend>
                <date>2013-02-18</date>
                <staticOvi>97.67</staticOvi>
            </staticovitrend>
            <staticovitrend>
                <date>2013-02-25</date>
                <staticOvi>93.36</staticOvi>
            </staticovitrend>
            <staticovitrend>
                <date>2013-03-04</date>
                <staticOvi>91.98</staticOvi>
            </staticovitrend>
        </staticovitrends>
    </apiResult>
</result>