Documentation

Category Rank API

The Category Rank API will return a given domain’s category and its global rank within its given category in either XML or JSON.

Features

  • Returns the category of a given domain and its global rank within its given category.
  • The category result is completly identical to the "Website Categorization API" output, but includes also the category rank.

How do we categorize websites?
The categorization algorithm is able to accurately classify an unknown website as one of 25 main categories and 219 sub-categories. The ability to algorithmically generate categories for a given list of websites is enormously powerful and can be used for lead generation, marketing segmentation and online filtering. SimilarWeb’s categorization engine uses a multi-class learning algorithm to generate a category for a given website using website content tags, similarity results and a learning set of 2.5M categorized websites. SimilarWeb’s categorization results are constantly improving through machine learning and incorporation of customer input. Category results are rigorously cross validated and tested.

Get the full categories' list here

Endpoints

Category Rank API endpoint : CategoryRank

JSON Endpoint Lookup

http://api.similarweb.com/Site/{domain}/v2/CategoryRank?Format=JSON&UserKey={UserKey}

XML Endpoint Lookup

http://api.similarweb.com/Site/{domain}/v2/CategoryRank?Format=XML&UserKey={UserKey}

Parameters

Params Description
Domain Enter your target domain including only the top-level and second-level names, ie: "google.com"
UserKey Enter the user key sent to you by email. You can also find your user key in the API dashboard.

One request to this API is worth 3 hits

Please note that sending one request to the SimilarSites API results in 3 hits being counted against your total number of monthly hits.

Example: Category rank API input for "ebay.com"

{
 http://api.similarweb.com/Site/ebay.com/v2/CategoryRank?Format=JSON&UserKey=[USERKEY]
}

Example: Category rank API ouput in json for "ebay.com"

{
 "Category": "Shopping",
 "CategoryRank": 1
}

FAQ

  1. Where can I find the full list of categories?

    You can find the full list of categories here.

  2. How often is the ranking data updated?

    The ranking for every website is updated on a monthly basis, on the first week of each month. This means that the global ranking you receive is the ranking for a website on the month in which the request is made.