Documentation > Reporting API > Research Methods

Keyword Research API

The Keyword Research API method provides a list of keyword suggestions, including:

Keyword
Type (related keyword, questions, related topic)
Average search volume
Avg. CPC
Relevance score

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

Refer to the 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.

Table of Contents

Parameters

key	string	The unique API key assigned to your account
keyword	string	Keyword
se_id	int	Search Engine ID, refer to Search Engine List API method
keyword_res_filter	string	Keyword Results Filter options: none (All Results) related (Related Keywords) questions (Keywords in the format of a question) topics (Related Topics)
results_limit_per_type	string	Optional: Limits the number of results per keyword results filter type Example: results_limit_per_type=20 will provide up to 20 results for the keyword_res_filter option selected
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.
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 an array instead of objects) &output=json&json_arr=true (causes the entire json to be wrapped as array)

Example Requests

Construct & test Keyword Research API requests in the API Console or follow one of these examples:

Keyword Research for all types limited to 20 results per type
https://www.rankranger.com/api/v2/?keyword_research_api&key=YourAPIkey&keyword=your-keyword&se_id=XXX&keyword_res_filter=none&results_limit_per_type=20&package_id=XXXX&output=xml

Keyword Research for Keywords in Question format, limited to 100 results
https://www.rankranger.com/api/v2/?keyword_research_api&key=YourAPIkey&keyword=your-keyword&se_id=XXX&keyword_res_filter=questions&results_limit_per_type=100&package_id=XXXX&output=json

Keyword Research for Related Topics with no limit on the number of results
https://www.rankranger.com/api/v2/?keyword_research_api&key=YourAPIkey&keyword=your-keyword&se_id=XXX&keyword_res_filter=topics&package_id=XXXX&output=xml

The default output is in XML format, if you would like the output to be JSON then you will need to add &output=json at the end of the string

Response Example

<tracking-data provider="rankranger" date="12/26/2018" time="15:47:36" status="ok">
    <lead_keyword>best action movies</lead_keyword>
    <results>
        <result>
            <keyword>best fiction movies</keyword>
            <type>related</type>
            <search_volume>1000</search_volume>
            <avg_cpc>1.37</avg_cpc>
            <relevance>91.891891891892</relevance>
        </result>
        <result>
            <keyword>the best action movies</keyword>
            <type>related</type>
            <search_volume>165000</search_volume>
            <avg_cpc>0.445127</avg_cpc>
            <relevance>90</relevance>
        </result>
        <result>
            <keyword>latest action movies</keyword>
            <type>related</type>
            <search_volume>8100</search_volume>
            <avg_cpc>0.21</avg_cpc>
            <relevance>89.473684210526</relevance>
        </result>
        <result>
            <keyword>best action movies 2015</keyword>
            <type>related</type>
            <search_volume>1900</search_volume>
            <avg_cpc>0.26</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>best action movies 2011</keyword>
            <type>related</type>
            <search_volume>1300</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>best action movies 2017</keyword>
            <type>related</type>
            <search_volume>74000</search_volume>
            <avg_cpc>1.407909</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>best action movies 2012</keyword>
            <type>related</type>
            <search_volume>1900</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>best action movies 2016</keyword>
            <type>related</type>
            <search_volume>40500</search_volume>
            <avg_cpc>1.280265</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>best action movies 2018</keyword>
            <type>related</type>
            <search_volume>9900</search_volume>
            <avg_cpc>3.93843</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>best action movies 2013</keyword>
            <type>related</type>
            <search_volume>12100</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>87.80487804878</relevance>
        </result>
        <result>
            <keyword>which are the best action movies</keyword>
            <type>questions</type>
            <search_volume>0</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>72</relevance>
        </result>
        <result>
            <keyword>who is the best action movie star</keyword>
            <type>questions</type>
            <search_volume>0</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>70.588235294118</relevance>
        </result>
        <result>
            <keyword>what was the first action movie</keyword>
            <type>questions</type>
            <search_volume>40</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>65.30612244898</relevance>
        </result>
        <result>
            <keyword>what defines an action movie</keyword>
            <type>questions</type>
            <search_volume>0</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>65.217391304348</relevance>
        </result>
        <result>
            <keyword>what do action movies contain</keyword>
            <type>questions</type>
            <search_volume>0</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>63.829787234043</relevance>
        </result>
        <result>
            <keyword>what new action movies are out</keyword>
            <type>questions</type>
            <search_volume>30</search_volume>
            <avg_cpc>0.138083</avg_cpc>
            <relevance>62.5</relevance>
        </result>
        <result>
            <keyword>what are science fiction movies</keyword>
            <type>questions</type>
            <search_volume>170</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>61.224489795918</relevance>
        </result>
        <result>
            <keyword>who is the best action hero</keyword>
            <type>questions</type>
            <search_volume>0</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>57.777777777778</relevance>
        </result>
        <result>
            <keyword>is fast and furious an action movie</keyword>
            <type>questions</type>
            <search_volume>10</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>56.603773584906</relevance>
        </result>
        <result>
            <keyword>what's the best family movie</keyword>
            <type>questions</type>
            <search_volume>0</search_volume>
            <avg_cpc>0</avg_cpc>
            <relevance>56.521739130435</relevance>
        </result>
        <result>
            <keyword>the imitation game</keyword>
            <type>topics</type>
            <search_volume>246000</search_volume>
            <avg_cpc>1.094121</avg_cpc>
            <relevance>55.555555555556</relevance>
        </result>
        <result>
            <keyword>action hero</keyword>
            <type>topics</type>
            <search_volume>3600</search_volume>
            <avg_cpc>0.291896</avg_cpc>
            <relevance>55.172413793103</relevance>
        </result>
        <result>
            <keyword>beasts of no nation</keyword>
            <type>topics</type>
            <search_volume>165000</search_volume>
            <avg_cpc>0.113485</avg_cpc>
            <relevance>54.054054054054</relevance>
        </result>
        <result>
            <keyword>being john malkovich</keyword>
            <type>topics</type>
            <search_volume>74000</search_volume>
            <avg_cpc>2.813486</avg_cpc>
            <relevance>52.631578947368</relevance>
        </result>
        <result>
            <keyword>the goonies</keyword>
            <type>topics</type>
            <search_volume>301000</search_volume>
            <avg_cpc>0.283484</avg_cpc>
            <relevance>48.275862068966</relevance>
        </result>
        <result>
            <keyword>science fiction film</keyword>
            <type>topics</type>
            <search_volume>9900</search_volume>
            <avg_cpc>0.06453</avg_cpc>
            <relevance>47.368421052632</relevance>
        </result>
        <result>
            <keyword>the hangover</keyword>
            <type>topics</type>
            <search_volume>201000</search_volume>
            <avg_cpc>1.985857</avg_cpc>
            <relevance>46.666666666667</relevance>
        </result>
        <result>
            <keyword>national treasure</keyword>
            <type>topics</type>
            <search_volume>201000</search_volume>
            <avg_cpc>0.154521</avg_cpc>
            <relevance>45.714285714286</relevance>
        </result>
        <result>
            <keyword>we're the millers</keyword>
            <type>topics</type>
            <search_volume>165000</search_volume>
            <avg_cpc>0.231154</avg_cpc>
            <relevance>45.714285714286</relevance>
        </result>
        <result>
            <keyword>fruitvale station</keyword>
            <type>topics</type>
            <search_volume>110000</search_volume>
            <avg_cpc>0.02077</avg_cpc>
            <relevance>45.714285714286</relevance>
        </result>
    </results>
</tracking-data>

AخA
 
<tracking-data provider="rankranger" date="12/26/2018" time="15:47:36" status="ok">    <lead_keyword>best action movies</lead_keyword>    <results>        <result>            <keyword>best fiction movies</keyword>            <type>related</type>            <search_volume>1000</search_volume>            <avg_cpc>1.37</avg_cpc>            <relevance>91.891891891892</relevance>        </result>        <result>            <keyword>the best action movies</keyword>            <type>related</type>            <search_volume>165000</search_volume>            <avg_cpc>0.445127</avg_cpc>            <relevance>90</relevance>        </result>        <result>            <keyword>latest action movies</keyword>            <type>related</type>            <search_volume>8100</search_volume>            <avg_cpc>0.21</avg_cpc>            <relevance>89.473684210526</relevance>        </result>        <result>            <keyword>best action movies 2015</keyword>            <type>related</type>            <search_volume>1900</search_volume>            <avg_cpc>0.26</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>best action movies 2011</keyword>            <type>related</type>            <search_volume>1300</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>best action movies 2017</keyword>            <type>related</type>            <search_volume>74000</search_volume>            <avg_cpc>1.407909</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>best action movies 2012</keyword>            <type>related</type>            <search_volume>1900</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>best action movies 2016</keyword>            <type>related</type>            <search_volume>40500</search_volume>            <avg_cpc>1.280265</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>best action movies 2018</keyword>            <type>related</type>            <search_volume>9900</search_volume>            <avg_cpc>3.93843</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>best action movies 2013</keyword>            <type>related</type>            <search_volume>12100</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>87.80487804878</relevance>        </result>        <result>            <keyword>which are the best action movies</keyword>            <type>questions</type>            <search_volume>0</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>72</relevance>        </result>        <result>            <keyword>who is the best action movie star</keyword>            <type>questions</type>            <search_volume>0</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>70.588235294118</relevance>        </result>        <result>            <keyword>what was the first action movie</keyword>            <type>questions</type>            <search_volume>40</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>65.30612244898</relevance>        </result>        <result>            <keyword>what defines an action movie</keyword>            <type>questions</type>            <search_volume>0</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>65.217391304348</relevance>        </result>        <result>            <keyword>what do action movies contain</keyword>            <type>questions</type>            <search_volume>0</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>63.829787234043</relevance>        </result>        <result>            <keyword>what new action movies are out</keyword>            <type>questions</type>            <search_volume>30</search_volume>            <avg_cpc>0.138083</avg_cpc>            <relevance>62.5</relevance>        </result>        <result>            <keyword>what are science fiction movies</keyword>            <type>questions</type>            <search_volume>170</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>61.224489795918</relevance>        </result>        <result>            <keyword>who is the best action hero</keyword>            <type>questions</type>            <search_volume>0</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>57.777777777778</relevance>        </result>        <result>            <keyword>is fast and furious an action movie</keyword>            <type>questions</type>            <search_volume>10</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>56.603773584906</relevance>        </result>        <result>            <keyword>what's the best family movie</keyword>            <type>questions</type>            <search_volume>0</search_volume>            <avg_cpc>0</avg_cpc>            <relevance>56.521739130435</relevance>        </result>        <result>            <keyword>the imitation game</keyword>            <type>topics</type>            <search_volume>246000</search_volume>            <avg_cpc>1.094121</avg_cpc>            <relevance>55.555555555556</relevance>        </result>        <result>            <keyword>action hero</keyword>            <type>topics</type>            <search_volume>3600</search_volume>            <avg_cpc>0.291896</avg_cpc>            <relevance>55.172413793103</relevance>        </result>        <result>            <keyword>beasts of no nation</keyword>            <type>topics</type>            <search_volume>165000</search_volume>            <avg_cpc>0.113485</avg_cpc>            <relevance>54.054054054054</relevance>        </result>        <result>            <keyword>being john malkovich</keyword>            <type>topics</type>            <search_volume>74000</search_volume>            <avg_cpc>2.813486</avg_cpc>            <relevance>52.631578947368</relevance>        </result>        <result>            <keyword>the goonies</keyword>            <type>topics</type>            <search_volume>301000</search_volume>            <avg_cpc>0.283484</avg_cpc>            <relevance>48.275862068966</relevance>        </result>        <result>            <keyword>science fiction film</keyword>            <type>topics</type>            <search_volume>9900</search_volume>            <avg_cpc>0.06453</avg_cpc>            <relevance>47.368421052632</relevance>        </result>        <result>            <keyword>the hangover</keyword>            <type>topics</type>            <search_volume>201000</search_volume>            <avg_cpc>1.985857</avg_cpc>            <relevance>46.666666666667</relevance>        </result>        <result>            <keyword>national treasure</keyword>            <type>topics</type>            <search_volume>201000</search_volume>            <avg_cpc>0.154521</avg_cpc>            <relevance>45.714285714286</relevance>        </result>        <result>            <keyword>we're the millers</keyword>            <type>topics</type>            <search_volume>165000</search_volume>            <avg_cpc>0.231154</avg_cpc>            <relevance>45.714285714286</relevance>        </result>        <result>            <keyword>fruitvale station</keyword>            <type>topics</type>            <search_volume>110000</search_volume>            <avg_cpc>0.02077</avg_cpc>            <relevance>45.714285714286</relevance>        </result>    </results></tracking-data>

How to Obtain API Access

How to Generate New API Keys

API Console: Construct & Test API Requests

API Query Limits

Developer API Methods

API Error Codes

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

Code	Text	Description
101	Invalid Method	Method does not exist, check your syntax
102	Invalid API Key	The API Key inserted is invalid, check for key accuracy
103	Invalid Domain	The Domain requested is invalid or does not exist in your account
104	Invalid Date	The selected date range or syntax is invalid
105	Invalid Keyword	The Keyword does not exist in this campaign
202	Invalid Campaign Name	The Campaign name is invalid or missing
203	Invalid Primary URL	The Primary URL is invalid or missing
204	Invalid Campaign ID	The Campaign ID is invalid or missing
208	Invalid Search Engine	Invalid Search Engine ID
210	Keyword already exists	The Keyword already exists in this campaign
211	Keywords exist in campaign	You need to delete Keywords from this campaign before trying to delete the campaign
212	Invalid Package ID	Invalid Package ID
215	Custom White Label URL is already in use for another campaign	The Custom URL that you have selected for your White Label Portal is in use by another campaign, please select a different URL
400	No Results	No results were found
401	Limit Reached	You have reached the maximum number of Campaigns allowed in your package
406	Too many processes requested	The account has exceeded the limit on the number of exports that can be run and stored via the Campaigns > Import & Export > Campaign Export tool. After downloading the files, you may delete them in the Campaign Export screen or via the API.

Keyword Research API

Parameters

Example Requests

Response Example

How to Obtain API Access

How to Generate New API Keys

API Console: Construct & Test API Requests

Getting Started: Samples of APIs used for Creating Campaigns

API Query Limits

Developer API Methods

Account Management

Account Data

Reporting API

Rank Data Methods

Research Methods

Search API

SEO Intelligence Methods

API FAQs

API Error Codes

Search our Knowledge Base
	Search