Keyword methods

The keyword methods of the SISTRIX API provide you with all data and information relating to keywords: organic rankings, ads and Universal Search results.

keyword

This method provides an overview of available additional methods for the respective keyword. In addition to the API key, the respective keyword must be mentioned. Please pay attention that this is encoded as a UTF-8 string. No credits will be charged for using this method.

Required parameters: api_key, kw

https://api.sistrix.com/keyword?api_key=$key&kw=london

keyword.seo

Returns information about the SERPs of the respective keyword. If the method is called without the “date” parameter, it will provide a list of possible query dates. For this listing, no credits will be charged. When passing the date parameter, the SERPs of the corresponding date will be provided. Besides the usual date format (ISO 8601), the date parameter will also accept statements such as “now” (current week) or “last week”. By specifying the “num” parameter, the number of results can be limited – for example, with a value of “10″ only the first 10 positions will be returned. With the domain or URL parameters, the output can be restricted to certain domains or URLs. A credit is charged for each returned position.

Required parameters: api_key, kw
Optional parameters: date, num, domain, url

https://api.sistrix.com/keyword.seo?api_key=$key&kw=london&date=now&num=20

keyword.sem

Returns the AdWords ads for the keyword. If the method is called without the “date” parameter, it provides a list of possible query dates. No credit will be charged for this listing. When passing the date parameter, the ads from that respective date will be returned. Besides the usual date format (ISO 8601), the date parameter will also accept statements such as “now” (current week) or “last week”. The number of results may be limited by specifying the “num” parameter – for example, with a value of “3″ only the first 3 ads will be returned. With the domain parameter, the output will be restricted to ads whose displayed URL corresponds with the respective domain. A credit is charged for each returned ad.

Required parameters: api_key, kw
Optional parameters: date, num, domain

https://api.sistrix.com/keyword.sem?api_key=$key&kw=credit&date=now&num=3

keyword.us

This method provides Universal Search integrations within the SERPs. If the method is called without the “date” parameter, it provides a list of possible query dates. For this listing, no credits will be charged. When passing the date parameter, results from the respective date will be returned. Besides the usual date format (ISO 8601), the date parameter will also accept statements such as “now” (current week) or “last week”. The assignment of the type specified for the Universal-Search integration happens via the Table in the Annex. The value of “position” is the ranking of the Universal Search box; the value “position.intern” the ranking of the corresponding URL within the Box.

Required parameters: api_key, kw
Optional parameters: date

https://api.sistrix.com/keyword.us?api_key=$key&kw=david+cameron&date=now

keyword.domain.seo

With this method, a domain’s keywords found within the organic Google ranking are displayed. If the method is called without the “date” parameter, it provides a list of possible query dates. For this listing, no credit will be charged. When passing the date parameter, ads from the respective date will be returned. Besides the usual date format (ISO 8601), the date parameter will also accept statements such as “now” (current week) or “last week”. By specifying the “num” parameter, the number of results can be limited. A credit is charged for each returned keyword. By passing a search term in the “search” parameter, keywords will be filtered and only those that contain that respective term will be returned. The “host” parameter limits the keyword search to a specific host name of the domain. The “url” parameter limits the keyword search to a specific URL of the domain, just like the “path” parameter limits the keyword search to a specific directory on the domain. The “from_pos” and “to_pos” parameters will limit the resulting keywords to their positions within the specified limits. The “extended” parameter can retrieve data from the extended keyword database. This is currently possible for Spain, Great Britain and Germany.

Required parameters: api_key, domain
Optional parameters: date, num, search, host, url, path, from_pos, to_pos, extended

https://api.sistrix.com/keyword.domain.seo?api_key=$key&domain=amazon.com&date=now&host=www.amazon.com

keyword.domain.sem

Displays the keywords for which AdWords ads of the corresponding domain were found. If the method is called without the “date” parameter, it will provide a list of possible query dates. For this listing no credit will be charged. When passing the date parameter, ads for the respective date will be returned. Besides the usual date format (ISO 8601), the date parameter will also accept statements such as “now” (current week) or “last week”. By specifying the “num” parameter, the number of results can be limited. A credit is charged for each returned keyword. By passing a search term in the “search” parameter, the keywords will be filtered and only those that contain that term will be returned. The “extended” parameter can retrieve data from the extended keyword database. This is currently possible for Spain, Great Britain and Germany.

Required parameters: api_key, domain
Optional parameters: date, num, search, extended

https://api.sistrix.com/keyword.domain.sem?api_key=$key&domain=amazon.com&date=now&search=london&num=20

keyword.domain.us

This method shows the keywords for which the domain shows up in Google’s Universal Search integrations. If the method is called without the “date” parameter, it provides a list of possible query dates. For this listing, no credits will be charged. When passing the date parameter, only ads from the respective date will be returned. Besides the usual date format (ISO 8601), the date parameter will also accept statements such as “now” (current week) or “last week”. By specifying the “num” parameter, the number of results can be limited. A credit is charged for each returned keyword. By submitting a search term in the “search” parameter, keywords will be filtered and only those that contain that respective term will be returned. The “host” parameter limits the keywords search to a specific host name of the domain. A credit is charged for each returned keyword. The assignment of the type specified for the Universal-Search integration happens via the Table in Annex. The value of “position” is the ranking of the Universal Search box, the value “position.intern” the ranking of the corresponding URL within the Box. The “extended” parameter can retrieve data from the extended keyword database. This is currently possible for Spain, Great Britain and Germany.

Required parameters: api_key, domain
Optional parameters: date, num, search, host, extended

https://api.sistrix.com/keyword.domain.us?api_key=$key&domain=amazon.com&date=now&num=20

Annex

“type” Number Description
1 shopping
2 news
3 blogs
4 images
5 videos
6 maps