getRankingColumn

Die Funktion gibt die Rankingverteilung der Domain zurück, also mit wie vielen Suchbegriffen die URL auf den Seiten 1 – 10 bei Google rankt.

Route	/keywords/getRankingColumn[/:key[/:urlpattern[/:sengine[/:format]]]]
Erforderliche Parameter	urlpattern sengine
Optionale Parameter	format
Rückgabewerte	column rankings
Querschnittverbindungen	getSearchEngines()
Hinweise	–

Parameter

keyword

Bezeichnung	Beschreibung	Wertebereich	Standardwert
sengine	Enthält ein von Xovi gecrawlte Suchmaschine.	s. getSearchEngines()	–
urlpattern	Die beobachtete Domain.	(www.|*)?(A-Z|a-z|0-9)+.(a-z|*)+	–
format	Legt fest in welchem Format das Ergebnis zurückgeliefert werden soll.	json|xml	json

Rückgabewerte

Bezeichnung	beschreibung	Wertebereich
column	Enthält eine Seitenzahl.	(0-9)+
rankings	Enthält die Anzahl der Keywords, die auf einer Seite ranken.	(0-9)+

Meldungen

Nachricht	Beschreibung
no permission	This key has no permission to access this function.
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'  => 'getRankingColumn',
    '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":[
        {"column":"1","rankings":"422"},
        {"column":"2","rankings":"210"},
        {"column":"3","rankings":"155"},
        {"column":"4","rankings":"143"},
        {"column":"5","rankings":"105"},
        {"column":"6","rankings":"87"},
        {"column":"7","rankings":"89"},
        {"column":"8","rankings":"85"},
        {"column":"9","rankings":"69"},
        {"column":"10","rankings":"1"}
    ]
}

XML

<?xml version="1.0"?>
<result>
     <apiErrorCode>0</apiErrorCode>
     <apiErrorMessage>0k.</apiErrorMessage>
     <apiResult>
         <rankingcolumns>
             <rankingcolumn>
                 <column>1</column>
                 <rankings>422</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>2</column>
                 <rankings>210</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>3</column>
                 <rankings>155</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>4</column>
                 <rankings>143</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>5</column>
                 <rankings>105</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>6</column>
                 <rankings>87</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>7</column>
                 <rankings>89</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>8</column>
                 <rankings></rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>9</column>
                 <rankings>69</rankgins>
             </rankingcolumn>
             <rankingcolumn>
                 <column>10</column>
                 <rankings>1</rankgins>
             </rankingcolumn> 
         </rankingcolumns> 
     </apiResult> 
</result>