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.

Hundreds of millions of keywords are available via the keywords methods of our API. Here, it is important to use the country parameter correctly to check the keywords in the respective country index.

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=[API_KEY]&kw=london

keyword.seo

Returns information about the SERPs of the respective keyword.

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.

The history parameter can be used to output historical values. However, this only works in combination with the url or domain parameters.

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, history, domain, url

https://api.sistrix.com/keyword.seo?api_key=[API_KEY]&kw=london&date=now&num=20

keyword.seo.traffic

This API function returns the search volume of a keyword. Learn more about determining the search volume.

In addition to the required parameters api_key and kw for the keyword, the optional country parameter can be used to select the country for which the search volume is to be output.

With the show-all parameter, all existing traffic values are output. The parameter show-all-countries returns all traffic values of the keyword from all countries.

One line equals one credit.

Required parameters: api_key, kw
Optional parameters: country, show-all, show-all-countries

https://api.sistrix.com/keyword.seo.traffic?api_key=[API_KEY]&kw=london

keyword.seo.serpfeatures

These API functions can be used to determine the SERP features for a keyword. We refer to the various elements that make up a search results page on Google as SERP features.

In SISTRIX, we track over 40 different SERP features. You can find a complete overview of all SERP features on this page.

In addition to the respective names of the SERP features, the API function also returns the number of occurrences of this SERP feature for the keyword being examined. If the optional parameter show-all-types is set to true, all SERP feature types are displayed and not only the ones found for this keyword.

One credit is charged for this function.

Required parameters: api_key, kw
Optional parameters: show-all-types

https://api.sistrix.com/keyword.seo.serpfeatures?api_key=[API_KEY]&kw=london

keyword.seo.searchintent

The search intent (also user intent) shows you the motivation behind a user’s search for a certain keyword. This API function returns an estimate of the search intent for a specific keyword.

A value between 0 and 100 is returned for the search intents Know, Know Simple, Visit, Website & Do. The higher this value, the more the respective search intent is fulfilled. You can find a more detailed explanation of the different search intents on this page.

Required parameters: api_key, kw
Optional parameters: country

https://api.sistrix.com/keyword.seo.searchintent?api_key=[API_KEY]&kw=hotels+london

keyword.sem

Returns the Google 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=[API_KEY]&kw=credit&date=now&num=3

keyword.us

Note: This method is outdated and will eventually be removed. Therefore, please use the keyword.seo.serpfeatures function in the future.

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 value position is the ranking of the Universal Search box; the value position.intern the ranking of the corresponding URL within the Box. The value 0 for position means that this Universal Search integration does not take up any organic space in the SERPs, but is additionally displayed.

Required parameters: api_key, kw
Optional parameters: date

https://api.sistrix.com/keyword.us?api_key=[API_KEY]&kw=david+cameron&date=now

keyword.domain.seo

With this method, the keywords found for a domain within the organic Google rankings are displayed.

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.

By specifying the num parameter, the number of results can be limited or increased. One credit is charged for each returned keyword. If not specified, a maximum of 100 results will be returned.

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 limit the results to the keywords with the positions within the specified frame.

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

https://api.sistrix.com/keyword.domain.seo?api_key=[API_KEY]&domain=amazon.com&date=now&host=www.amazon.com

keyword.domain.sem

Displays the keywords for which Google 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.

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

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

keyword.domain.us

Note: This method is outdated and will eventually be removed.

This method shows the keywords for which integrations exist in Universal Search boxes of the domain examined. 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 value 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.

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

https://api.sistrix.com/keyword.domain.us?api_key=[API_KEY]&domain=amazon.com&date=now&num=20