Features Resources Blog Pricing Help Sign In
  •  
Documentation > Reporting API > Research Methods
Search our Knowledge Base
Search

Keyword Search Volume API



The Keyword Search Volume API method provides the following data for the list of keywords queried:
  • Keyword
  • Average Global Search Volume (country-based volume can be achieved using the Local Volume Settings)
  • Average Cost Per Click (CPC)
  • PPC Competition score

This API is intended to be used to obtain an initial list of keywords with average search volume, and then again after adding new keywords. Search volume may be updated as often as once per month, if Google has updates available.

The daily usage limit for this API is based on the package capacity.

Refer to Rank Ranger API Overview page for information on how to obtain API access, obtain an API Key, error codes and a full list of API methods.




 
 

Parameters

 
key string The unique API key assigned to your account
keyword string Keyword(s)
Enter a comma "," between keywords when requesting search volume for more than one keyword.
package_id int The Rank Ranger Package ID can be obtained by running the Get Packages Info API
Packages have a capacity for Site Explorer requests, and this API utilizes that capacity. 
ccode string (Optional) Country Code can be added to the request if local search volume has been configured.
To utilize this feature, refer to the Local Volume Settings and Country Code List sections in this document.
output string Output format options:
  • &output=xml  (this is the default format)
  • &output=json
    Either of these parameters can be added to the json output parameter:
    • &output=json&json_strict=true 
      (forces the results to come back as array instead of objects) 
    • &output=json&json_arr=true 
      (causes the entire json to be wrapped as array)


Example Requests

 

Construct & test Keyword Volume API requests in the API Console or follow one of these examples:
Keyword Volume for 1 Keyword
https://www.rankranger.com/api/v2/?keyword_volume_api&key=YourAPIkey&keyword=your-keyword&package_id=XXXX
Keyword Volume for Multiple Keywords - limited to 300 keywords per request
https://www.rankranger.com/api/v2/?keyword_volume_api&key=YourAPIkey&keyword=keyword1,keyword2,keyword3,keyword4,keyword5,keyword6,keyword7,keyword8,keyword9,keyword10&package_id=XXXX
Keyword Volume for Multiple Keywords (limited to 300 keywords per request) and country-based data
https://www.rankranger.com/api/v2/?keyword_volume_api&key=YourAPIkey&keyword=keyword1,keyword2,keyword3,keyword4,keyword5,keyword6,keyword7,keyword8,keyword9,keyword10&package_id=XXXX&ccode=gb
The default output is in XML format, if you would like the output to be json the you will need to add &output=json at the end of the string

 

Response Example

             
 

AخA
 
<tracking-data provider="rankranger" date="01/07/2019" time="13:16:21" status="ok">
    <results>
        <result>
            <keyword>vegetarian recipes</keyword>
            <search_volume>165000</search_volume>
            <avg_cpc>1.33</avg_cpc>
            <competition>0.31</competition>
        </result>
        <result>
            <keyword>best apple pie recipe</keyword>
            <search_volume>14800</search_volume>
            <avg_cpc>0.28</avg_cpc>
            <competition>0.09</competition>
        </result>
        <result>
            <keyword>heart healthy recipes</keyword>
            <search_volume>9900</search_volume>
            <avg_cpc>1.89</avg_cpc>
            <competition>0.44</competition>
        </result>
        <result>
            <keyword>pasta recipes</keyword>
            <search_volume>201000</search_volume>
            <avg_cpc>0.75</avg_cpc>
            <competition>0.24</competition>
        </result>
        <result>
            <keyword>slow cooker recipes</keyword>
            <search_volume>368000</search_volume>
            <avg_cpc>0.566082</avg_cpc>
            <competition>0.1574705836255</competition>
        </result>
        <result>
            <keyword>chicken recipes</keyword>
            <search_volume>673000</search_volume>
            <avg_cpc>1.12</avg_cpc>
            <competition>0.40</competition>
        </result>
        <result>
            <keyword>chocolate cake recipe</keyword>
            <search_volume>246000</search_volume>
            <avg_cpc>0.60</avg_cpc>
            <competition>0.10</competition>
        </result>
        <result>
            <keyword>soup recipes</keyword>
            <search_volume>201000</search_volume>
            <avg_cpc>0.71</avg_cpc>
            <competition>0.20</competition>
        </result>
        <result>
            <keyword>appetizer ideas</keyword>
            <search_volume>22200</search_volume>
            <avg_cpc>1.41</avg_cpc>
            <competition>0.37</competition>
        </result>
        <result>
            <keyword>bread recipes</keyword>
            <search_volume>90500</search_volume>
            <avg_cpc>0.53</avg_cpc>
            <competition>0.17</competition>
        </result>
        <result>
            <keyword>healthy recipes</keyword>
            <search_volume>246000</search_volume>
            <avg_cpc>1.13</avg_cpc>
            <competition>0.45</competition>
        </result>
        <result>
            <keyword>easy healthy recipes</keyword>
            <search_volume>27100</search_volume>
            <avg_cpc>1.44</avg_cpc>
            <competition>0.22</competition>
        </result>
    </results>
</tracking-data>

   

Response Errors

             
 
If you get this error it means that you have queried a keyword for which we don't have data, and it has been added to our research queue. You may try the keyword again in a few hours, however, if there is a large queue of keywords it could be up to 24 hours for the data to be ready for retrieval (note: you will not be charged additional credits for requesting the same keyword).

 
<tracking-data provider="rankranger" date="02/16/2020" time="16:06:38" status="error" code="507">
    <error-details>
the keyword(s) doesn't exist in our database but has been added to our research queue, please check again later
</error-details>
</tracking-data>



If you get this error it means that your account has used all of the keyword research capacity allotted for 1 month. You may purchase additional units by contacting your account manager for a package upgrade.

 
<tracking-data provider="rankranger" date="02/16/2020" time="16:00:14" status="error" code="503">
    <error-details>Monthly limit reached</error-details>
</tracking-data>


Campaign Local Volume Settings

             
 
Change from Global to Country-based Search Volume
The Local Volume Settings option is available at the bottom of the Campaign Settings > Keywords screen for API packages. To utilize this option, scroll to the bottom of the Keywords screen, select a country and click the Update button. 

local volume setting


Status: In Queue
While local volume data is being collected for the campaign keywords, the Local Volume status will indicate that it is "in queue". 

local volume queue


Local Volume Updated
When the local volume data collection has been completed, the status indicates "Last Update:" followed by the date. 

local volume updated


Local Volume Service Limit Reached
If you attempt to update the local volume more one time per month, you will receive a message indicating that a volume update request was already completed during the period. 

local volume limit reached



How to Obtain API Access

More

How to Generate New API Keys

More

API Console: Construct & Test API Requests

More

API Query Limits

More

Developer API Methods

More

API Error Codes

More

Country Code List

More

Get the ultimate SEO tools with the Rank Ranger Software
Learn More About Rank Ranger

Featured SEO Tools
SEO Dashboard Rank Tracker Social Analytics Link Manager White Label SEO
Marketing Dashboard Keyword Finder Insight Graph API
Resources
Top 100 Websites Rank Risk Index Google Algorithm Updates Google SERP Features Tool Mobile SERP Features Tool Visual Guide to SERP Features SEO Glossary
Rank Ranger
Pricing Contact us Blog Help Center Documentation Brand Ambassadors
Copyright © 2025 Rank Ranger ®, LLC. All Rights Reserved.     Terms of Use | Privacy Policy