getDomainTrend

Gibt den Verlauf wichtiger Kennzahlen einer Domain zurück.

Route	/links/getDomainTrend[/:key[/:domain[/:format[/:limit[/:skip[/:cached]]]]]]
Erforderliche Parameter	domain
Optionale Parameter	format limit (max:1000) skip cached
Rückgabewerte	trendDate domainPop webpagePOP backlinkPOP ipPop classCPop
Querschnittverbindungen	–
Hinweise	Limit: Das maximale Limit ist 1000. Um mehr Ergebnisse zu erhalten, benutzen Sie den Parameter Skip. cached: Wird der optianle Parameter cached auf „true“ gesetzt, werden die aktuellen Daten des Caches ausgelesen. Das beschleunigt die Abfrage. Jedoch werden nur die Daten domainPop, ipPop und backlinkPop ausgegeben. Die anderen Attribute haben den Wert ’n/a‘. resultCount: Enthält die Anzahl des Ergebnisses ohne Filter. Wird z.B. bei der Paginierung benötigt.

Parameter

Bezeichnung	Beschriebung	Wertebereich	Standardwert
domain	Enthält einen qualifizierten Domainnamen.	(www.)?(A-Z|a-z|0-9)+. (a-z)+	–
limit	Legt fest, wie viele Ergebniszeilen zurückgegeben werden sollen. (max:1000)	(0-9)+	1
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
cached	Wird der optianle Parameter cached auf „true“ gesetzt, werden die aktuellen Daten des Caches ausgelesen. Das beschleunigt die Abfrage. Jedoch werden nur die Daten domainPop, ipPop und backlinkPop ausgegeben. Die anderen Attribute haben den Wert ’n/a‘.	true|false	false

Rückgabewerte

Ein numerisches Array von Arrays folgenden Elementen

Bezeichnung	Beschreibung	Wertebereich
trendDate	Datum der Datenerhebung	Datum im Format yyyy-mm-dd
domainPop	Anzahl der linkenden Domains	uint
webpagePOP	Anzahl der linkenden Webseiten	uint
backlinkPOP	Anzahl der Backlinks	uint
ipPop	Anzahl der unterschiedlichen linkenden IP-Adressen	uint
classCPop	Anzahl der unterschiedlichen linkenden IP-Adressen in den ersten 3. Blöcken	uint

Meldungen

Nachricht	Beschreibung
maximum limit exeeded	Das maximale Limit wurde überschritten.
no permission	Der Schlüssel hat keinen Zugriff auf die 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' => 'links',
    'method'  => 'getDomainTrend',
    'key'     => 'myPersonalKey',
    'domain'  => 'www.xovi.de',
    'format'  => 'xml',
);
$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":[{
         "trendDate":"2013-03-11",
         "domainPop":"928",
         "webpagePOP":"15095",
         "backlinkPOP":"18591",
         "ipPop":"989",
         "classCPop":"725"
     }]
}

XML

<?xml version="1.0"?>
<result>
    <apiErrorCode>0</apiErrorCode>
    <apiErrorMessage>0k.</apiErrorMessage>
    <apiResult>
        <domains>
            <domain>
                <trendDate>2013-03-11</trendDate>
                <domainPop>928</domainPop>
                <webpagePOP>15095</webpagePOP>
                <backlinkPOP>18591</backlinkPOP>
                <ipPop>989</ipPop>
                <classCPop>725</classCPop>
            </domain>
        </domains>
    </apiResult>
</result>