Optimizer methods

The SISTRIX Optimizer enables regular on-page evaluations for your websites. Additionally, you can query individual keywords and create your own project Visibility Index score. The Optimizer methods for the API allow access to this data via a machine-readable interface.

optimizer.projects

This method returns the hash values and names of the existing optimizer projects. No credits are used in this process.

Required parameter: api_key

https://api.sistrix.com/optimizer.projects?api_key=$key

optimizer.project

This method returns information about an optimizer project and the existing tags. Here, the project hash – which can be requested via method optimizer.projects – is transferred to the parameter “project”. With this query, no credits are used.

Required parameter: api_key, project

https://api.sistrix.com/optimizer.project?api_key=$key&project=$hash

optimizer.ranking

This method returns the keywords and existing rankings for an Optimizer project. Here, the project hash is transferred to the parameter “project”. Via the “limit” parameter you can reduce the number of rows returend (where the default value is 100 results); with “tag”, keywords can be filtered according to an existing tag. One returned row costs one credit.

Required parameter: api_key, project
Optional parameter: limit, offset, tag

https://api.sistrix.com/optimizer.ranking?api_key=$key&project=$hash

optimizer.visibility

This method can be used to return the Project Visibility Index for a specific Optimizer project. Please use the project hash with the project parameter. You can also declare an optional date parameter, which will show the results for a previous week. By using the tag parameter you can return the Visibility Index for a specific project-tag. By setting the optional parameter competitors to true, we will also return the results for the competitors that are specified in the specific Optimizer project.

Required parameter: api_key, project
Optional parameter: date, tag, competitors

https://api.sistrix.com/optimizer.visibility?api_key=$key&project=$hash

optimizer.keyword.serps

This method will return the SERPs for a specific keyword within the Optimizer. Please use the project hash with the project parameter. You can also refine your search by using the country, city, device and searchengine parameters to filter your results. This is very useful if you have more than one keyword by the same name. Without the above filter-parameters, the API will return the first keyword found, by default.
You can use the parameter date to query data from previous weeks and num to limit the number of results.

Required parameter: api_key, project, kw
Optional parameter: country, city, device, searchengine, date, num

https://api.sistrix.com/optimizer.keyword.serps?api_key=$key&project=$hash&kw=$keyword

optimizer.onpage.overview

This method returns all available onpage crawl data. Aside from the time of the crawl, you will receive data on the number of pages crawled and the errors, warnings and hints that were found during the crawl.

Required parameter: api_key, project

https://api.sistrix.com/optimizer.onpage.overview?api_key=$key&project=$hash

optimizer.onpage.crawl

This method returns all the results for a specific onpage crawl. You can use the date parameter to request the data for a previous crawl. You can find all the possible dates through the optimizer.onpage.overview query.

Required parameter: api_key, project
Optional parameter: date

https://api.sistrix.com/optimizer.onpage.crawl?api_key=$key&project=$hash

optimizer.onpage.issue

This method returns detailed results for a specific onpage crawl. You can use the issue parameter to request individual results from the issues you get from the onpage.optimizer.crawl query. By using the date parameter you can request the results for previous crawls.

Required parameter: api_key, project, issue
Optional parameter: date, limit, offset

https://api.sistrix.com/optimizer.onpage.issue?api_key=$key&project=$hash&issue=$issue