Optimizer-Methoden

Der SISTRIX Optimizer ermöglicht dir die regelmäßige Onpage-Analyse deiner Webseiten. Zusätzlich kannst du individuelle Keywords abfragen und einen eigenen Projekt-Sichtbarkeitsindex erstellen. Die Optimizer-Methoden der API lassen den Zugriff auf diese Daten über eine maschinenlesbare Schnittstelle zu.

Bei API-Abfragen innerhalb der Optimizer-Methoden werden generell keine Credits des Toolbox-Accounts verbraucht.

optimizer.projects

Diese Methode gibt die Projekt-Identifikatoren und Namen der vorhandenen Optimizer Projekte zurück.

Benötigte Parameter: api_key

https://api.sistrix.com/optimizer.projects?api_key=[API_KEY]

optimizer.project

Diese Methode gibt Informationen über ein Optimizer Projekt und den vorhandenen Tags zurück. Dem Parameter project wird hierbei der Projekt-Hash übergeben, der über die Methode optimizer.projects erhalten werden kann.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.project?api_key=[API_KEY]&project=[PROJECT]

optimizer.ranking

Diese Methode gibt die Keywords und vorhandene Rankings zu einem Optimizer Projekt zurück. Dem Parameter project wird hierbei der Projekt-Identifikator übergeben. Über den Parameter limit kann die Ergebnismenge reduziert werden (standardmäßig werden 100 Ergebnisse angezeigt), mit tag lassen sich die Keywords nach einem vorhandenen Tag filtern.

Die Ausgabe enthält zusätzlich Informationen über das ausgewählte Device, die Suchmaschine und das Land. Mehrere Tags werden durch das Zeichen „|“  getrennt.

Benötigte Parameter: api_key, project
Optionaler Parameter: limit, offset, tag

https://api.sistrix.com/optimizer.ranking?api_key=[API_KEY]&project=[PROJECT]

optimizer.visibility

Diese Methode gibt die Sichtbarkeit eines Optimizer Projektes zurück. Dem Parameter project wird hierbei der Projekt-Identifikator übergeben. Mit dem Parameter date lässt sich ein vergangener Wert anzeigen, mit tags wird der Projekt-Sichtbarkeitsindex gefiltert nach Tag ausgegeben. Wird der Wert competitors auf true gesetzt werden zusätzlich die im Projekt ausgewählten Wettbewerber angezeigt.

Benötigte Parameter: api_key, project
Optionaler Parameter: date, tag, competitors

https://api.sistrix.com/optimizer.visibility?api_key=[API_KEY]&project=[PROJECT]

optimizer.keyword.serps

Diese Methode gibt die SERPs eines im Optimizer angelegten Keywords zurück. Dem Parameter project wird hierbei der Projekt-Identifikator übergeben. Um die Suche zu verfeinern, kann nach Land, Stadt, Gerätetyp und Suchmaschine gefiltert werden. Das empfiehlt sich vor allem dann, wenn es mehr als ein Keyword mit dem gleichen Namen gibt. Ohne Filter nimmt die API standardmäßig das erste Keyword, das gefunden wird.
Über den Parameter date können vergangene Werte abgefragt werden, num beschränkt das Ergebnis auf die gewünschte Anzahl.

Benötigte Parameter: api_key, project, kw
Optionaler Parameter: country, city, device, searchengine, date, num

https://api.sistrix.com/optimizer.keyword.serps?api_key=[API_KEY]&project=[PROJECT]&kw=[KEYWORD]

optimizer.onpage.overview

Diese Methode liefert alle verfügbaren Onpage-Crawl-Daten zurück. Diese enthalten neben der Zeit auch die gecrawlten Seiten und die gefundenen Fehler, Warnungen und Hinweise.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.onpage.overview?api_key=[API_KEY]&project=[PROJECT]

optimizer.onpage.crawl

Diese Methode liefert alle Ergebnisse eines Onpagecrawls zurück. Mit dem Parameter date können vergangene Ergebnisse abgefragt werden. Die Abfragezeitpunkte können über die Funktion optimizer.onpage.overview erhalten werden.

Benötigte Parameter: api_key, project
Optionaler Parameter: date

https://api.sistrix.com/optimizer.onpage.crawl?api_key=[API_KEY]&project=[PROJECT]

optimizer.onpage.issue

Diese Methode liefert detailierte Ergebnisse eines Onpagecrawls zurück. Mit den Parameter issue lassen sich die einzelnen Ergebnisse aufrufen, die möglichen Werte können über die Funktion optimizer.onpage.crawl erfragt werden. Über den Parameter date können vergangene Ergebnisse abgefragt werden.

Benötigte Parameter: api_key, project, issue
Optionaler Parameter: date, limit, offset

https://api.sistrix.com/optimizer.onpage.issue?api_key=[API_KEY]&project=[PROJECT]&issue=[ISSUE]

optimizer.start.onpage.check

Mit dieser Methode kannst du einen Onpage-Crawl für ein Optimizer-Projekt über die API starten. Der Crawldurchlauf erfolgt dann so, als ob er manuell im Frontend von SISTRIX gestartet worden wäre. Die genutzten URL-Aufrufe werden dem Kontingent des SISTRIX-Accounts abgezogen.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.start.onpage.check?project=[PROJECT]&api_key=[API_KEY]

optimizer.competitors

Gibt Wettbewerber der Domain zurück auf Basis des eingetragenen Keyword Sets. Neben dem Domainnamen wird auch der Grad der Übereinstimmung (0-100) zurückgeliefert. Mit dem Parameter num lässt sich die Anzahl der zurückgegebenen Domains reduzieren, ohne Angabe werden 100 Treffer ausgegeben.

Benötigte Parameter: api_key, project
Optionaler Parameter: num

https://api.sistrix.com/optimizer.competitors?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.urls

Diese Methode liefert dir alle gecrawlten HTML-Seiten des Projektes. Sie entspricht damit der Tabelle „URL“ unter Onpage > Expertenmodus im Frontend von SISTRIX. Neben der URL werden auch die weiteren Felder der Tabelle (wie Dateigröße, Title-Tag und mehr) bereitgestellt.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.project.urls?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.links

Diese Methode liefert dir alle gefunden Links des Projektes. Das umfasst sowohl interne als auch externe Verlinkungen. Sie entspricht damit der Tabelle „Links“ unter Onpage > Expertenmodus im Frontend von SISTRIX.

Benötigte Parameter: api_key, project
Optionalter Parameter: limit

https://api.sistrix.com/optimizer.project.links?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.resources

Diese Methode liefert dir alle gefunden Ressourcen (Bilder, Javascript- und CSS-Dateien) des Projektes. Sie entspricht damit der Tabelle „Ressourcen“ unter Onpage > Expertenmodus im Frontend von SISTRIX.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.project.resources?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.resources.usage

Diese Methode zeigt dir, wo die gefundenen Ressourcen konkret eingebunden/genutzt werden. Sie entspricht damit der Tabelle „Nutzung Ressourcen“ unter Onpage > Expertenmodus im Frontend von SISTRIX.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.project.resources.usage?api_key=[API_KEY]&project=[PROJECT]

optimizer.project.cookies

Diese Methode zeigt dir, welche Cookies in dem gecrawlten Projekt genutzt werden. Der SISTRIX-Onpagecrawler erfasst dabei alle Cookies, die der Webserver setzen möchte, speichert diese aber nur und verwendet sie nicht. Sie entspricht damit der Tabelle „Cookies“ unter Onpage > Expertenmodus im Frontend von SISTRIX.

Benötigte Parameter: api_key, project

https://api.sistrix.com/optimizer.project.cookies?api_key=[API_KEY]&project=[PROJECT]
21.02.2024