Displays the top AdWords positions for the specified keywords, sorted from highest to lowest. To filter the results for a specific domain, use the DOMAIN parameter. The COUNTRY parameter allows you to specify the desired country. Use the LIMIT parameter to restrict the number of displayed AdWords rankings.
Result
The result contains a list of AdWord positions for the given keyword. Each entry includes its position relative to other AdWord rankings for the keyword (position), the general position in the SERPs (total_position), the title (title), and the text (text) of the AdWord ranking. Additionally, the URL of the ranking (displayurl) and the type (type) are provided.GET-Parameters
Parameters (Mandatory)
api_key
STRING
Your personal API key. This key is used to authenticate your requests. You can obtain it here.
kw
STRING
Defines the keyword to which the method is applied.
Parameters (Optional)
limit
INTEGER
Specifies the maximum numbers of AdWord rankings to be displayed in the result.
country
STRING / countrycode
Defines the country for which the method will be executed. You can find a list of available country codes here. If no Country parameter is provided, the default country associated with the Toolbox account will be used.
domain
STRING
Specifies the domain for which the top-ranking AdWords positions of the specified keyword are retrieved. This parameter allows you to focus the analysis on a particular domain within the addword search results.
format
STRING
Specifies whether the response will be returned in XML or JSON format. By default, the result will be in XML format.
To be able to use the API documentation with real data, you have to create an API key in your account.
EXAMPLE
$baseUrl = "https://api.sistrix.com/keyword.sem";
$post = [
];
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $baseUrl);
curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
curl_close($curl);
import requests
baseUrl = 'https://api.sistrix.com/keyword.sem'
post = {
}
response = requests.post(baseUrl, post)
data = response.text
curl https://api.sistrix.com/keyword.sem \
let baseUrl = 'https://api.sistrix.com/keyword.sem';
let form = new FormData();
fetch(baseUrl, {
method: 'POST',
body: form
}).then(function(response){
return response.text();
}).then(function(data){
//data contains the results of the request
})