SEOLizer- API

Mit unserer API hast Du direkten Zugriff auf unsere Domaindaten. Dazu zählen Funktionen wie

  • Finde thematisch ähnliche Domains (Similar Domains)
  • Finde Domains die auf eine bestimmte Domain weiterleiten (301 Redirects)
  • Gebe die aktuelle Trustedshops- Bewertung zurück (Verlauf eines Zeitraums ist auch möglich)
  • Finde Domains auf einer angegebenen IP- Adresse (Domain- Reverse- Lookup)

Du kannst Domaindaten abrufen, Projekte verwalten und Projektdaten abrufen.

Aktuelle Version: V1.1

API- Funktionsübersicht

Accountfunktionen

FunktionBeschreibung
getmandantdataLiestet die Stammdaten des Mandanten auf

Domainfunktionen

FunktionBeschreibung
getdomainsonipListet alle Domains von einer angegebenen IP- Adresse auf (Reverse- IP- Lookup)
isdomainexistsPrüft ob eine Domain im SEOLizer bekannt ist
gettsdomainvalues
readdomainLiefert Detailinformationen zu einer Domain
getdomainforscreeninterne Verwendung
adddomainFügt einer Domain in dem Index vom SEOLizer hinzu sofern SEOLizer die Domain nicht schon kennt

Domainlisten- Funktionen

Funktion Beschreibung
getdomainlistsGibt eine Übersicht mit Domainlisten zurück

Projektfunktionen

FunktionBeschreibung
createprojectLegt ein neues Projekt in dem eigenen Account an
delprojectLöscht ein Projekt aus dem Account
startauditStartet eine neues Lighthouse- Audit
startcrawlStartet eine neue [SEO-Analyse]
getprojectlistGibt eine Liste aller Projekte in dem Account zurück]

Sonstige Funktionen

FunktionBeschreibung
putimageinterne Verwendung
getgeonameinterne Verwendung
getgeonamesinterne Verwendung
adddomaintoredisinterne Verwendung

Autorisierung an der API

Unsere API nutzt ein einfachen Autorisierungscode der als Parameter (key) jeder API- Anfrage angehängt werden muss. Beipielaufruf:

https://seolizer.de/api/current/?action=isdomainexists&key=[DeinKey]&domain=test.de

Ungültige Anfragen an unserer API werden nach einer bestimmten Anzahl von Versuchen für eine gewisse Zeit blockiert. Dies dient dem Schutz vor Missbrauch unserer API und Deinen Credits.

Fehlermeldung bei ungültigem API-Key

<domain>
    <request credits="0">  // Ihrem Konto wurden keine Credits belastet, da die Funktion mit einem Fehler zurückgegeben wurde
        <action>isdomainexists</action>  // Funktionsaufruf
        <domain>test.de</domain>  // Domain
    </request>
    <response version="1.1">
        <errorno>300</errorno>  // Fehlercode
        <error>Invalid ApiKey</error>  // Fehlermeldung im Klartext
    </response>
</domain>

Ein API- Key bekommen

Für die meisten API- Anfragen benötigen Sie ein gültigen API- Key. Diesen können Sie als Administrator Ihres Accounts direkt erstellen.

Credits pro Anfrage

Pro API- Call berechnen wir je nach Art der Anfrage eine gewisse Anzahl an Credits. Die Credits werden in Ihrem Account automatisch jeden Sonntag um 23:59 Uhr wieder aufgefüllt. So stehen Ihnen je nach gebuchtem Paket eine gewisse Anzahl an Credits zur freien Verfügung. Wie viel Credits ein API- Call verbraucht entnhemen Sie bitte der Dokumentation der jeweiligen Funktion.

Anfragen an der API

Jede Anfrage kann und muss als HTTP- Get- Request gesendet werden.

Spezielle API- Version verwenden

Standardmäßig verwenden wir immer die aktuellste API- Version.

Beipielaufruf:

https://seolizer.de/api/current/?action=isdomainexists&key=[DeinKey]&domain=test.de

Dabei ist die Angabe „current“ dabei der Schlüssel um immer auf die aktuellste Version zuzugreifen. Wenn Du eine spezielle Version verwenden möchtest kannst Du die natürlich unter Angabe der gewünschten Versinsnummer.

Beipielaufruf für einen Call an die API der Version 1.0:

https://seolizer.de/api/1.0/?action=isdomainexists&key=[DeinKey]&domain=test.de

Eine Beispiel-Antwort der API

<domain>
  <request credits="10">  // Der Aufruf kostete 10 Credits
    <action>readdomain</action>  // Die Funktion readdomain wurde aufgerufen
  </request>
  <response version="1.1">  // Antwort der API mit der Version 1.1
    <errorno>0</errorno>  // Fehlercode 0 wurde zurückgegeben (Fehlerfrei durchgeführt)
    <domain>test.de</domain>  // Antwort bezieht sich auf die Domain test.de
    <id>859676</id>  // interne Verwaltungsschlüssel der Domain
    <ip hostcount="35">52.174.71.95</ip>  // IP- des Servers auf dem die Domain gehostet wird, 35 weitere Domains auf der IP bekannt
    <ipnet>52.168.0.0/13</ipnet>  // Subnet in dem sich der Server befindet
    <provider>Microsoft Corporation</provider>  // Zuständiger Provider
    <cms>Noxum Website Publisher</cms>  // entdecktes CMS der Website
    <imprintUrl/>  // URL zum Impressum
    <gtmid/>  // Google- Tag- Manager- Conatiner- ID
    <dataProtectionUrl>  // URL zur Datenschutzerklärung
      <redirectdomains domaincount="25">  // 25 Domains leiten per Redirect auf die Domain test.de um
        <domain>alternative-heilmethoden-im-test.de</domain>
        <domain>fettest.de</domain>
        <domain>finanztest24.de</domain>
        <domain>finanz-test.de</domain>
      </redirectdomains>
      <similardomains domaincount="28"> // 28 ähnliche Webseiten bekannt
        <domain>verbraucherzentrale.de</domain>
        <domain>guter-rat.de</domain>
        <domain>warentest.de</domain>
      </similardomains>
    </response>
</domain>

Wichtige Fragen