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>