Documentation

Host Detection

Fetch Who-Hosts-This.com data with curl, guzzle or your favorite HTTP client.

Curl Example

curl -G https://www.who-hosts-this.com/APIEndpoint/Detect \
--data-urlencode key="Your-api-key" \
--data-urlencode url="en.wikipedia.org"

Request Parameters

The API query requires two parameters: the url you want to check and your api key.

Result JSON

Responses are JSON encoded and have the following format.

{
    "request": "https://www.who-hosts-this.com/others/Who-Hosts-This/APIEndpoint/Detect?key=YOUR-API-KEY&url=en.wikipedia.org",
    "request_web": "https://www.who-hosts-this.com/?s=en.wikipedia.org",
    "result": {
        "code": 200,
        "msg": "Success: CMS or Host Found"
    },
    "results": [
        {
            "ip": "2620:0:861:ed1a::1",
            "type": "AAAA",
            "isp_id": "544",
            "isp_name": "Wikimedia Foundation Inc.",
            "isp_url": "https://localhost/others/Who-Hosts-This/544-Wikimedia-Foundation-Inc"
        },
        {
            "ip": "198.35.26.96",
            "type": "A",
            "isp_id": "544",
            "isp_name": "Wikimedia Foundation Inc.",
            "isp_url": "https://localhost/others/Who-Hosts-This/544-Wikimedia-Foundation-Inc"
        }
    ]
}

PHP Wrapper

The who-hosts-this-php wrapper can help you easily integrate hosting provider detections into any PHP application. This package is open source and hosted on Github.

We recommended installing who-hosts-this-php through Composer.

curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version:

php composer.phar require whatcms/who-hosts-this-php

Once installed, you can use the WhoHostsThis class to fetch results:

require 'vendor/autoload.php';
$key = 'Your API Key';
$detector = new \WhoHostsThis\WhoHostsThis($key);
$check_url = 'en.wikipedia.org';
$result	 = $detector->CheckUrl($check_url);
print_r($result);

CMS Detection

Fetch WhatCMS.org data with curl, guzzle or your favorite HTTP client.

Curl Example

curl -G https://whatcms.org/APIEndpoint/Detect \
--data-urlencode key="Your-api-key" \
--data-urlencode url="en.wikipedia.org"

Request Parameters

The API query requires two parameters: the url you want to check and your api key.

Result JSON

Responses are JSON encoded and have the following format.

{
    "request": "https://whatcms.org/APIEndpoint/Detect?key=YOUR-API-KEY&url=en.wikipedia.org",
    "request_web": "https://whatcms.org/?s=en.wikipedia.org",
    "result": {
        "code": 200,
        "msg": "CMS Found",
        "id": 8,
        "name": "MediaWiki",
        "confidence": "high",
        "cms_url": "https://whatcms.org/c/8_MediaWiki"
    }
}

PHP Wrapper

The whatcms-php wrapper can help you easily integrate WhatCMS detections into any PHP application. This package is open source and hosted on Github.

We recommended installing whatcms-php through Composer.

curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of WhatCMS:

php composer.phar require whatcms/whatcms-php

Once installed, you can use the WhatCMS class to fetch results:

require 'vendor/autoload.php';
$key = 'Your API Key';
$detector = new \WhatCMS\WhatCMS($key);
$check_url = 'en.wikipedia.org';
$result	 = $detector->CheckUrl($check_url);
print_r($result);

Technology Detection

The technology endpoint provides a more complete picture of the software powering webpages. In addition to detecting the CMS, this endpoint will return the programming language, database, web server and more of the requested url.

Curl Example

curl -G https://whatcms.org/Special_APIEndpointV2 \
--data-urlencode key="Your-api-key" \
--data-urlencode url="en.wikipedia.org"

Request Parameters

The API query requires two parameters: the url you want to check and your api key.

Result JSON

Responses are JSON encoded and have the following format.

{
    "request": "https://whatcms.org/APIEndpoint/Technology?key=4ac0c57c5f2ec2b1bf7e0bfaaef52e91f44eaecbd5a8e640cd69435bc95ab96b856aef&url=en.wikipedia.org",
    "request_web": "https://whatcms.org/?s=en.wikipedia.org",
    "result": {
        "code": 200,
        "msg": "Success"
    },
    "results": [
        {
            "categories": [
                "Wiki"
            ],
            "name": "MediaWiki",
            "url": "https://whatcms.org/c/MediaWiki",
            "version": "1.34.0"
        },
        {
            "categories": [
                "Programming Language"
            ],
            "name": "PHP",
            "version": ""
        },
        {
            "categories": [
                "Web Server"
            ],
            "name": "HHVM",
            "version": "3.18.6"
        }
    ]
}

WordPress Theme Detection

Fetch ThemeDetect.com data with curl, guzzle or your favorite HTTP client.

Curl Example

curl -G https://www.themedetect.com/APIEndpoint/Detect \
--data-urlencode key="Your-api-key" \
--data-urlencode url="blog.mozilla.org"

Request Parameters

The API query requires two parameters: the url you want to check and your api key.

Result JSON

Responses are JSON encoded and have the following format.

{
    "request": "https://www.themedetect.com/others/ThemeDetect/APIEndpoint?url=blog.mozilla.org&key=4ac0c57c5f2ec2b1bf7e0bfaaef52e91f44eaecbd5a8e640cd69435bc95ab96b856aef",
    "request_web": "https://www.themedetect.com/?s=blog.mozilla.org",
    "result": {
        "code": 200,
        "msg": "Success"
    },
    "results": [
        {
            "theme_uri": "https://github.com/craigcook/frontierline-theme",
            "theme_name": "Frontierline",
            "author": "Craig Cook, Michael Ham, and all your friends at Mozilla",
            "author_uri": "https://www.mozilla.org",
            "version": "2.4",
            "license": "GPL GNU General Public License v3 or later",
            "license_uri": "http://www.gnu.org/licenses/gpl-3.0.html",
            "template": "",
            "description": "A theme for official Mozilla blogs.",
            "tags": null
        }
    ]
}

Status Endpoint

You can use the status endpoint for checking your account totals.

Example Response

{
    "request": "https://whatcms.org/APIEndpoint/Status?key=YOUR-API-KEY",
    "result": {
        "code": 200,
        "msg": "Success",
        "period_start": 1520722943,
        "period_end": 1523401343,
        "period_quota": 10000,
        "period_requests": 406,
        "period_remaining": 9594
    }
}

Rate Limiting

Rate limits help us make sure our system remains stable and available to all of our users.

Please note, some API queries will require us to fetch the requested url. If the server for the requested url is slow to respond, our results will also be delayed. We allow up to 20 seconds for responses to complete.

Result Codes