Documentation

Global and Country Rank

This endpoint will allow you view the Global and Country* Rank of the domain.

*Country Rank is available for enterprise customers


Parameters

Params Description
Domain Enter your target domain including only the top-level and second-level names, ie: "cnn.com", "edition.cnn.com"
Start Month (start_date) Start Month (YYYY-MM)
End Month (end_date) End Month (YYYY-MM)
Main Domain (main_domain_only) True /False
True returns data for main domain only
False returns data for subdomains as well.
UserKey (api_key) Enter your unique API Key
Granularity (granularity) Daily/Weekly/Monthly
Returns data in requested format

Example: Global Rank API input for “cnn.com”


{
https://api.similarweb.com/v1/website/cnn.com/global-rank/global-rank?api_key={UserKey}&start_date=2016-01&end_date=2016-03&main_domain_only=false
}

Example: Global Rank API output for “cnn.com”


{
    {  
   "meta":{  
      "request":{  
         "domain":"cnn.com",
         "start_date":"2016-01-01",
         "end_date":"2016-03-01",
         "country":"world"
      },
      "status":"Success",
      "last_updated":"2016-06-01"
   },
   "global_rank":[  
      {  
         "date":"2016-01",
         "global_rank":143
      },
      {  
         "date":"2016-02",
         "global_rank":121
      },
      {  
         "date":"2016-03",
         "global_rank":115
      }
   ]
}
}