Search our Knowledge Base
Search

Competitor Research API



The Competitor Research API method provides a list of up to 100 competitor domains.

Requests for Organic results include:
  • Competitor domain
  • Number of keywords ranking in the top 10 search results
  • Number of keywords competitor has in common with queried domain
  • Percentage of common keywords
  • Number of keywords unique to the competitor
  • Number of keywords unique to the queried domain
Requests for Paid results include:
  • Competitor domain
  • Number of paid keywords
  • Number of paid keywords competitor and queried domain have in common
  • Percentage of common paid keywords
  • Number of paid keywords unique to competitor
  • Number of paid keywords unique to the queried domain

For information on how to obtain API access, a key, error codes, etc. please select the relevant option from the Table of Contents below.

The daily usage limit for this API is based on the number of Site Explorer URLs per day included in your package. If you require additional capacity, please contact us for package upgrade pricing.




 
 

Parameters

 
key string The unique API key assigned to your account
domain string domain URL
se_id int Search Engine ID, refer to Search Engine List API method 
index_type
string Options:
  • organic
  • paid
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 array instead of objects) 
    • &output=json&json_arr=true 
      (causes the entire json to be wrapped as array)


Example Requests

 

Construct & test Competitor Research API requests in the API Console or follow one of these examples:
Organic Competitors, XML format
https://www.rankranger.com/api/v2/?competitor_research_api&key=YourAPIkey&domain=domain.com&se_id=XXX&index_type=organic&package_id=XXXX&output=xml

Paid Competitors, JSON format
https://www.rankranger.com/api/v2/?competitor_research_api&key=YourAPIkey&domain=domain.com&se_id=XXX&index_type=paid&package_id=XXXX&output=json


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

Organic Response Example

             
 

x
 
<tracking-data provider="rankranger" date="01/08/2019" time="14:52:14" status="ok">
    <domain>ebay.com</domain>
    <type>paid</type>
    <se_id>1</se_id>
    <results>
        <result>
            <competitor>bestdeals.today</competitor>
            <paid_keywords>12682</paid_keywords>
            <common_keywords>1976</common_keywords>
            <common_keywords_percent>7.5827928930504</common_keywords_percent>
            <competitor_unique>10706</competitor_unique>
            <domain_unique>13377</domain_unique>
        </result>
        <result>
            <competitor>amazon.com</competitor>
            <paid_keywords>129160</paid_keywords>
            <common_keywords>8310</common_keywords>
            <common_keywords_percent>6.1011871985199</common_keywords_percent>
            <competitor_unique>120850</competitor_unique>
            <domain_unique>7043</domain_unique>
        </result>
        <result>
            <competitor>discount99.us</competitor>
            <paid_keywords>2347</paid_keywords>
            <common_keywords>387</common_keywords>
            <common_keywords_percent>2.2353145035522</common_keywords_percent>
            <competitor_unique>1960</competitor_unique>
            <domain_unique>14966</domain_unique>
        </result>
        <result>
            <competitor>target.com</competitor>
            <paid_keywords>18944</paid_keywords>
            <common_keywords>745</common_keywords>
            <common_keywords_percent>2.2204339532666</common_keywords_percent>
            <competitor_unique>18199</competitor_unique>
            <domain_unique>14608</domain_unique>
        </result>
        <result>
            <competitor>findsimilar.com</competitor>
            <paid_keywords>7171</paid_keywords>
            <common_keywords>387</common_keywords>
            <common_keywords_percent>1.7482043637349</common_keywords_percent>
            <competitor_unique>6784</competitor_unique>
            <domain_unique>14966</domain_unique>
        </result>
        <result>
            <competitor>walmart.com</competitor>
            <paid_keywords>8174</paid_keywords>
            <common_keywords>320</common_keywords>
            <common_keywords_percent>1.3788942991339</common_keywords_percent>
            <competitor_unique>7854</competitor_unique>
            <domain_unique>15033</domain_unique>
        </result>
        <result>
            <competitor>bhphotovideo.com</competitor>
            <paid_keywords>2866</paid_keywords>
            <common_keywords>171</common_keywords>
            <common_keywords_percent>0.94747340425532</common_keywords_percent>
            <competitor_unique>2695</competitor_unique>
            <domain_unique>15182</domain_unique>
        </result>
        <result>
            <competitor>applerubber.com</competitor>
            <paid_keywords>499</paid_keywords>
            <common_keywords>130</common_keywords>
            <common_keywords_percent>0.82686681083832</common_keywords_percent>
            <competitor_unique>369</competitor_unique>
            <domain_unique>15223</domain_unique>
        </result>
        <result>
            <competitor>savesmart.com</competitor>
            <paid_keywords>1966</paid_keywords>
            <common_keywords>108</common_keywords>
            <common_keywords_percent>0.6275056649817</common_keywords_percent>
            <competitor_unique>1858</competitor_unique>
            <domain_unique>15245</domain_unique>
        </result>
        <result>
            <competitor>bestbuy.com</competitor>
            <paid_keywords>4431</paid_keywords>
            <common_keywords>107</common_keywords>
            <common_keywords_percent>0.54378208060172</common_keywords_percent>
            <competitor_unique>4324</competitor_unique>
            <domain_unique>15246</domain_unique>
        </result>
----- Up to as many as 100 results -----
    </results>
</tracking-data>


Paid Response Example

            
 

 
<tracking-data provider="rankranger" date="01/08/2019" time="14:52:14" status="ok">
    <domain>ebay.com</domain>
    <type>paid</type>
    <se_id>1</se_id>
    <results>
        <result>
            <competitor>bestdeals.today</competitor>
            <paid_keywords>12682</paid_keywords>
            <common_keywords>1976</common_keywords>
            <common_keywords_percent>7.5827928930504</common_keywords_percent>
            <competitor_unique>10706</competitor_unique>
            <domain_unique>13377</domain_unique>
        </result>
        <result>
            <competitor>amazon.com</competitor>
            <paid_keywords>129160</paid_keywords>
            <common_keywords>8310</common_keywords>
            <common_keywords_percent>6.1011871985199</common_keywords_percent>
            <competitor_unique>120850</competitor_unique>
            <domain_unique>7043</domain_unique>
        </result>
        <result>
            <competitor>discount99.us</competitor>
            <paid_keywords>2347</paid_keywords>
            <common_keywords>387</common_keywords>
            <common_keywords_percent>2.2353145035522</common_keywords_percent>
            <competitor_unique>1960</competitor_unique>
            <domain_unique>14966</domain_unique>
        </result>
        <result>
            <competitor>target.com</competitor>
            <paid_keywords>18944</paid_keywords>
            <common_keywords>745</common_keywords>
            <common_keywords_percent>2.2204339532666</common_keywords_percent>
            <competitor_unique>18199</competitor_unique>
            <domain_unique>14608</domain_unique>
        </result>
        <result>
            <competitor>findsimilar.com</competitor>
            <paid_keywords>7171</paid_keywords>
            <common_keywords>387</common_keywords>
            <common_keywords_percent>1.7482043637349</common_keywords_percent>
            <competitor_unique>6784</competitor_unique>
            <domain_unique>14966</domain_unique>
        </result>
        <result>
            <competitor>walmart.com</competitor>
            <paid_keywords>8174</paid_keywords>
            <common_keywords>320</common_keywords>
            <common_keywords_percent>1.3788942991339</common_keywords_percent>
            <competitor_unique>7854</competitor_unique>
            <domain_unique>15033</domain_unique>
        </result>
        <result>
            <competitor>bhphotovideo.com</competitor>
            <paid_keywords>2866</paid_keywords>
            <common_keywords>171</common_keywords>
            <common_keywords_percent>0.94747340425532</common_keywords_percent>
            <competitor_unique>2695</competitor_unique>
            <domain_unique>15182</domain_unique>
        </result>
----- Up to as many as 100 results -----
    </results>
</tracking-data>



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

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