API

Die Methoden des Bereiches Monitoring ermöglichen den API-Zugriff auf die wesentlichen Funktionen aus dem Bereich Monitoring.

Keywords

Gibt alle im Projekt definierten Keywords zurück.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/Keywords/?projectHash=[projectHash]&apiKey=[apiKey]

Tags

Gibt alle im Projekt definierten Tags zurück.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/Tags/?projectHash=[projectHash]&apiKey=[apiKey]

Rankings

Gibt die aktuellen Rankings zu allen im Projekt definierten Keywords aus.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
date (optional) : Das Datum zu dem die Rankingpositionen angezeigt werden sollen. Die Angabe erfolgt im Unix-Timestamp-Format. Wird dieser Parameter nicht angegeben, wird das aktuelle Datum verwendet.
limit (optional) : Anzahl der angezeigten Ergebnisse. Wird dieser Wert nicht angegeben, werden die ersten 100 Ergebnisse angezeigt. Es können maximal 1000 Ergebnisse angezeigt werden.
offset (optional) : Gibt die Anzahl der Ergebnisse an, die übersprungen werden.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
competitorDomain (optional) : Gibt die Domain eines Wettbewerbers an. Wird dieser Wert gesetzt, beziehen sich die Ergebnisse auf die Domain des Wettbewerbers. Wird kein Wert gesetzt, wird die Hauptdomain des Projektes (eigene Domain) verwendet.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/Rankings/?projectHash=[projectHash]&apiKey=[apiKey]

RankingChanges

Ermittel, was sich die Rankingsergebnisse, der im Projekt definierten Keywords zwischen zwei Datumsangaben verändert haben.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
limit (optional) : Anzahl der angezeigten Ergebnisse. Wird dieser Wert nicht angegeben, werden die ersten 100 Ergebnisse angezeigt. Es können maximal 1000 Ergebnisse angezeigt werden.
offset (optional) : Gibt die Anzahl der Ergebnisse an, die übersprungen werden.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
fromDate (optional) : Das Ausgangsdatum von dem die Veränderungen berechnet werden sollen. Die Angabe erfolgt im Unix-Timestamp-Format. Wird dieser Parameter nicht angegeben, wird das aktuelle Datum abzüglich einer Woche verwendet.
toDate (optional) : Das Enddatum zu dem die Veränderungen berechnet werden sollen. Die Angabe erfolgt im Unix-Timestamp-Format. Wird dieser Parameter nicht angegeben, wird das aktuelle Datum verwendet.
typeFilter (optional) : Filter den Typ der Veränderungen. Mögliche Werte: all (default), winner, looser, in, out.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
competitorDomain (optional) : Gibt die Domain eines Wettbewerbers an. Wird dieser Wert gesetzt, beziehen sich die Ergebnisse auf die Domain des Wettbewerbers. Wird kein Wert gesetzt, wird die Hauptdomain des Projektes (eigene Domain) verwendet.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/RankingChanges/?projectHash=[projectHash]&apiKey=[apiKey]

KeywordProspects

Ermittelt die Keywords mit den besten Chancen.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
limit (optional) : Anzahl der angezeigten Ergebnisse. Wird dieser Wert nicht angegeben, werden die ersten 100 Ergebnisse angezeigt. Es können maximal 1000 Ergebnisse angezeigt werden.
offset (optional) : Gibt die Anzahl der Ergebnisse an, die übersprungen werden.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/KeywordProspects/?projectHash=[projectHash]&apiKey=[apiKey]

UrlSwitches

Ermittelt mögliche URL-Wechsel der best positionierten Rankings zu dem im Projekt eingetragenen Keywords.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
limit (optional) : Anzahl der angezeigten Ergebnisse. Wird dieser Wert nicht angegeben, werden die ersten 100 Ergebnisse angezeigt. Es können maximal 1000 Ergebnisse angezeigt werden.
offset (optional) : Gibt die Anzahl der Ergebnisse an, die übersprungen werden.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
competitorDomain (optional) : Gibt die Domain eines Wettbewerbers an. Wird dieser Wert gesetzt, beziehen sich die Ergebnisse auf die Domain des Wettbewerbers. Wird kein Wert gesetzt, wird die Hauptdomain des Projektes (eigene Domain) verwendet.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/UrlSwitches/?projectHash=[projectHash]&apiKey=[apiKey]

MultipleUrlRankings

Ermittelt alle Rankings der im Projekt definierten Keywörter, die mit mehr als einer URL in der jeweiligen SERP gelistet sind.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
limit (optional) : Anzahl der angezeigten Ergebnisse. Wird dieser Wert nicht angegeben, werden die ersten 100 Ergebnisse angezeigt. Es können maximal 1000 Ergebnisse angezeigt werden.
offset (optional) : Gibt die Anzahl der Ergebnisse an, die übersprungen werden.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
competitorDomain (optional) : Gibt die Domain eines Wettbewerbers an. Wird dieser Wert gesetzt, beziehen sich die Ergebnisse auf die Domain des Wettbewerbers. Wird kein Wert gesetzt, wird die Hauptdomain des Projektes (eigene Domain) verwendet.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/MultipleUrlRankings/?projectHash=[projectHash]&apiKey=[apiKey]

MainKpis

Ermittelt die Hauptkennzahlen (KPIs) zu einem Projekt Enthält den Ranking-Index, die Anzahl der in den Top 10/100 rankenden Keywords/URLs und die durchschnittliche Top-Position der rankenden Keywords.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
competitorDomain (optional) : Gibt die Domain eines Wettbewerbers an. Wird dieser Wert gesetzt, beziehen sich die Ergebnisse auf die Domain des Wettbewerbers. Wird kein Wert gesetzt, wird die Hauptdomain des Projektes (eigene Domain) verwendet.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/MainKpis/?projectHash=[projectHash]&apiKey=[apiKey]

KeywordSerp

Ermittelt die Suchergebnisse zu einem angegebenen Keyword.
Ein Aufruf dieser API-Methode wird mit 1 Credit berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
date (optional) : Das Datum zu dem die SERP-Ergebnisse angezeigt werden sollen. Die Angabe erfolgt im Unix-Timestamp-Format. Wird dieser Parameter nicht angegeben, wird das aktuelle Datum verwendet.
keyword (optional) : Für dieses Keyword werden die Suchergebnisse ermittelt.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/KeywordSerp/?projectHash=[projectHash]&apiKey=[apiKey]

Competitors

Gibt die definierten Wettbewerber und deren RankingIndex, sowie die Anzahl der Rankings zurück.
Ein Aufruf dieser API-Methode wird mit 2 Credits berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/Competitors/?projectHash=[projectHash]&apiKey=[apiKey]

CompetitorRankings

Gibt die Rankings der definierten Wettbewerber zurück.
Ein Aufruf dieser API-Methode wird mit 3 Credits berechnet.
Parameter:
projectHash : Der Hashwert zur Identifizierung des Projektes.
apiKey : Der individuelle API-Key, welchen wir dir in deinem Benutzerprofil bereitstellen.
format (optional) : Gibt das Ausgabeformat an. Mögliche Werte sind json (Standardwert) und xml.
tagfilter (optional) : Enthält eine kommassierte Liste von Tags. Ist der Wert gesetzt, werden nur Ergebnisse angezeigt, die mit mindestens einem der angegebenen Tags versehen sind.
Beispielaufruf:
https://api.pagerangers.com/Monitoring/CompetitorRankings/?projectHash=[projectHash]&apiKey=[apiKey]