getRankingValue

Gibt den Wert einer Domain errechnet aus Position, Suchvolumen, CPC und Trafficfaktor zu einem bestimmten Zeitpunkt zurück.

Route	/keywords/getRankingValue[/:key[/:urlpattern[/:sengine[/:format[/:date]]]]]
ERFORDERLICHE PARAMETER	urlpattern sengine
OPTIONALE PARAMETER	format date
RÜCKGABEWERTE	rankingvalue
QUERSCHNITTVERBINDUNGEN	getSearchEngines()
HINWEISE	–

Parameter

BEZEICHNUNG	BESCHREIBUNG	WERTEBEREICH	STANDARDWERT
urlpattern	Enthält ein Url Muster.	(www.|*)?(A-Z|a-z|0-9)+.(a-z|*)+	–
sengine	Enthält eine von Xovi gecrawlte Suchmaschine.	google.de|google.at|google.ch| bing.de	–
date	Enthält ein Datum nach ISO8601	Datum: YYYY-MM-DD	Das Datum der Vorwoche
format	Legt fest in welchem Format das Ergebnis zurückgeliefert werden soll.	json|xml	json

Rückgabewerte

BEZEICHNUNG	BESCHREIBUNG	WERTEBEREICH
rankingvalue	Zeigt den Wert einer Domain.

Meldungen

NACHRICHT	BESCHREIBUNG
no permission	Der Schlüssel hat keinen Zugriff auf diese Funktion.
urlpattern not supported	Die übergebene Url kann in der Form nicht verarbeitet werden.
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'  => 'getRankingValue',
    'key'     => 'yourPersonalKey',
    'urlpattern' => 'www.xovi.de',
    'sengine' => 'google.de',
    'format'  => 'json',
);
$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":{ 
         "rankingvalue":"552728.88"
     }
}

XML

<?xml version="1.0"?>
<result>
    <apiErrorCode>0</apiErrorCode>
    <apiErrorMessage>0k.</apiErrorMessage>
    <apiResult>
        <rankingvalues>
            <rankingvalue>
                <rankingvalue>552728.88</rankingvalue>
            </rankingvalue>
        </rankingvalues>
    </apiResult>
</result>