Chinese Firewall Test API

Check if any Domain is Blocked in China

Our Chinese Firewall Test API checks whether a given domain name is blocked by the Great Firewall of China using both DNS and HTTP tests.

Automate monitoring of your domains for censorship within mainland China and stay one step ahead of the censors.

Get Started for Free

Why Choose ViewDNS.info Chinese Firewall Test API?

  • In-Country Infrastructure Ensuring Accurate Results
  • Live Data Ensuring Up To Date Results
  • Highly Scalable to meet Business Needs
  • Automate Monitoring of Single URLs or Entire Domains
  • Subscription Includes Access to ALL ViewDNS.info APIs

Our Valued Customers Include:

Blizzard DuckDuckGo Kaspersky NTT LaPoste

Key Chinese Firewall Test API Features

Live Data

Our API retrieves data in real-time, ensuring that the most up to date censorship results are available.

Highly Scalable

Our Chinese Firewall Test API employs a highly scalable backend ensuring that even high volume checks are met with the highest success rate.

In-Country Infrastructure

Our API utilises in-country infrastructure with tests conducted using real connections to ensure the most accurate results.

Automate Your Monitoring

Our API can test a single URL or an entire domain allowing for a unified approach to monitoring for censorship of your content.

Get Started for Free

Usage Details

Test if any URL or domain is blocked in China.

/chinesefirewall GET

https://api.viewdns.info/chinesefirewall/

Checks whether a given URL or domain is accessible from multiple locations in mainland China.

Parameters

  • apikey required

    Your API key associated with your ViewDNS.info account.

  • domain required

    The domain or URL to perform the censorship test on (e.g., example.com).

  • output optional (default=json)

    The output format required ('xml' or 'json').

Sample Request Live Demo!

https://api.viewdns.info/chinesefirewall/?domain=domain.com&apikey=demo&output=json

Sample Response

{
  "query": {
    "tool": "chinesefirewall_PRO",
    "domain": "domain.com"
  },
  "expectedresponse": "104.18.42.197 172.64.145.59 ",
  "response": {
    "detail": {
      "server": [
        {
          "location": "Beijing",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Shenzhen",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Inner Mongolia",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Heilongjiang Province",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Yunnan Province",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        }
      ]
    },
    "summary": {
      "result": "visible",
      "description": "All servers were able to reach your site at the correct IP address.  This means that the hostname itself is accessible from within mainland China."
    }
  },
  "v2response": {
    "dnsresults": {
      "server": [
        {
          "location": "Beijing",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Shenzhen",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Inner Mongolia",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Heilongjiang Province",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        },
        {
          "location": "Yunnan Province",
          "resultvalue": "104.18.42.197 172.64.145.59",
          "resultstatus": "ok"
        }
      ],
      "summary": "visible",
      "description": "All servers were able to reach your site at the correct IP address.  This means that the hostname itself is accessible from within mainland China."
    },
    "httpresults": {
      "detail": "HTTP/200 OK",
      "summary": "ok",
      "description": "This URL appears to be accessible from mainland China."
    }
  }
}

Code Example

OSZAR »