NAV Navbar
Logo

Introduction

Web Shrinker is a SaaS (Software as a Service) provider. We offer APIs that can be used in a variety of programming languages and, in some cases, directly within HTML code. Currently we have three public facing APIs: Website Category Lookup API, Website Domain API, and Website Screenshot API.

Website Category API

HTTP/1.1 200 OK
Content-Type: application/json

{
    "data": [
        {
            "categories": [
                {
                    "confident": true,
                    "id": "IAB19",
                    "label": "Technology & Computing",
                    "parent": "IAB19",
                    "score": "0.855809166500086094"
                },
                {
                    "confident": true,
                    "id": "IAB19-18",
                    "label": "Internet Technology",
                    "parent": "IAB19",
                    "score": "0.824063117153139624"
                }
            ],
            "url": "webshrinker.com"
        }
    ]
}

Web Shrinker utilizes cloud computing and machine learning to classify websites into a set of categories. The resulting URL to category mappings are made available as an online API and also as a downloadable list so you can integrate and use it with other software and services.

Perhaps you’re building an Internet website filter and need to block certain categories such as adult and social networking sites. Maybe you are running a hosting company and want to enforce an Acceptable Use Policy to prevent customers from running a file sharing or classified ads network. These would be two possible examples of how the website category lookup API can be used.

The current API version is v3.

View the Category v3 API documentation

Website Domain API

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "addresses": {
      "ipv4": {
        "199.16.156.230": [
          "2017-03-20T13:27:10Z"
        ]
      }
    },
    "categories": [
      "socialnetworking"
    ],
    "host": "twitter.com",
    "language": "en",
    "related": [
      "business.twitter.com",
      "brand.twitter.com",
      "blog.twitter.com",
      "ads.twitter.com",
      "support.twitter.com",
      "careers.twitter.com",
      "discover.twitter.com",
      "tweetdeck.twitter.com",
      "mobile.twitter.com",
      "2014.twitter.com",
      "2013.twitter.com",
      "mobile.blog.twitter.com",
      "publish.twitter.com",
      "dev.twitter.com",
      "apiwiki.twitter.com",
      "partners.twitter.com",
      "marketing.twitter.com",
      "jobs.twitter.com",
      "transparency.twitter.com",
      "2015.twitter.com",
      "analytics.twitter.com",
      "about.twitter.com",
      "api.twitter.com",
      "apps.twitter.com",
      "engineering.twitter.com"
    ]
  }
}

The Web Shrinker Domain API gives you the ability to search through and retrieve data that we accumulate from analyzing billions of URLs each month.

Request information on a specific domain name or IP address: Returns the primary language used for the site, its main categories, the server IP addresses used to host the site, as well as known sub-domain names.

Retrieve domain backlinks: Returns a list of external websites that link to the requested domain name, including link attributes such as ‘rel’, 'text’, and 'alt’.

Retrieve domain outbound links: Returns a list of websites that the requested domain name is linking to, including link attributes such as 'rel’, 'text’, and 'alt’.

The current API version is v2.

View the Domain v2 API documentation

Website Screenshot API

The Web Shrinker screenshot/thumbnail API gives you the ability to capture an image of what a particular website looks like in a browser window. You can then include these images in your own web pages or do some other processing on them in your preferred programming language. This technique has been used on many popular sites including the major search engines.

It is also possible to automatically pixelate screenshots for websites that are categorized as an “adult” site, reducing the chances that you would be displaying questionable content to your users.

An example of what a screenshot can look like can be seen next to this paragraph. The image being displayed is of the main Web Shrinker web site generated by our servers using our own API.

The current API version is v2.

View the Screenshot v2 API documentation