Chinese Firewall Test
Checks whether a site is blocked by the Great Firewall of China. This test checks across a number of servers from various locations in mainland China to determine if access to the site provided is possible from behind the Great Firewall of China.
This test checks for symptoms of DNS poisoning, one of the more common methods used by the Chinese government to block access to websites.
Note: Version 2 of this API has now been implemented. Please use the 'v2response' data as the original 'response' data will be removed in the near future (it is currently kept in the response only for compatibility).
URL
https://api.viewdns.info/chinesefirewall/
Parameters
domain - the domain name to test
output - the output format required ('xml' or 'json')
apikey - your api key
Sample Query - Pass Case
domain: test.com
GET https://api.viewdns.info/chinesefirewall/?domain=test.com&apikey=yourapikey&output=output_type
XML Response (output=xml)
<?xml version='1.0' encoding='ISO-8859-1'?>
<viewdns>
<query>
<tool>chinesefirewall_PRO</tool>
<domain>test.com</domain>
</query>
<expectedresponse>174.36.85.72</expectedresponse>
<response>
<detail>
<server>
<location>Beijing</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Shenzen</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Inner Mongolia</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Heilongjiang Province</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Yunnan Province</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
</detail>
<summary>
<result>visible</result>
<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.</description>
</summary>
</response>
<v2response>
<dnsresults>
<detail>
<server>
<location>Beijing</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Shenzen</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Inner Mongolia</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Heilongjiang Province</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
<server>
<location>Yunnan Province</location>
<resultvalue>174.36.85.72</resultvalue>
<resultstatus>ok</resultstatus>
</server>
</detail>
<summary>visible</summary>
<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.</description>
</dnsresults>
<httpresults>
<detail>HTTP/1.1 200 OK</detail>
<summary>ok</summary>
<description>This URL appears to be accessible from mainland China.</description>
</httpresults>
</v2response>
</viewdns>
JSON Response (output=json)
{
"query": {
"tool": "chinesefirewall_PRO",
"domain": "test.com"
},
"expectedresponse": "174.36.85.72",
"response": {
"detail": {
"server": [
{
"location": "Beijing",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Shenzen",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Inner Mongolia",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Heilongjiang Province",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Yunnan Province",
"resultvalue": "174.36.85.72",
"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": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Shenzen",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Inner Mongolia",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Heilongjiang Province",
"resultvalue": "174.36.85.72",
"resultstatus": "ok"
},
{
"location": "Yunnan Province",
"resultvalue": "174.36.85.72",
"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/1.1 200 OK",
"summary": "ok",
"description": "This URL appears to be accessible from mainland China."
}
}
}
Sample Query - Fail Case
domain: twitter.com
GET https://api.viewdns.info/abuselookup/?domain=twitter.com&apikey=yourapikey&output=output_type
XML Response (output=xml)
<?xml version='1.0' encoding='ISO-8859-1'?>
<viewdns>
<query>
<tool>chinesefirewall_PRO</tool>
<domain>twitter.com</domain>
</query>
<expectedresponse>199.59.148.82 199.59.150.39 199.59.150.7</expectedresponse>
<response>
<detail>
<server>
<location>Beijing</location>
<resultvalue>59.24.3.173</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Shenzen</location>
<resultvalue>37.61.54.158</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Inner Mongolia</location>
<resultvalue>59.24.3.173</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Heilongjiang Province</location>
<resultvalue>59.24.3.173</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Yunnan Province</location>
<resultvalue>93.46.8.89</resultvalue>
<resultstatus>fail</resultstatus>
</server>
</detail>
<summary>
<result>not_visible</result>
<description>No servers were able to reach your site on the correct IP address. This means that any URL's on this host are most likely NOT accessible from within mainland China.</description>
</summary>
</response>
<v2response>
<dnsresults>
<detail>
<server>
<location>Beijing</location>
<resultvalue>59.24.3.173</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Shenzen</location>
<resultvalue>37.61.54.158</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Inner Mongolia</location>
<resultvalue>59.24.3.173</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Heilongjiang Province</location>
<resultvalue>59.24.3.173</resultvalue>
<resultstatus>fail</resultstatus>
</server>
<server>
<location>Yunnan Province</location>
<resultvalue>93.46.8.89</resultvalue>
<resultstatus>fail</resultstatus>
</server>
</detail>
<summary>not_visible</summary>
<description>No servers were able to reach your site on the correct IP address. This means that any URL's on this host are most likely NOT accessible from within mainland China.</description>
</dnsresults>
<httpresults>
<detail>Connection timed out.</detail>
<summary>error</summary>
<description>This URL appears to be blocked in China.</description>
</httpresults>
</v2response>
</viewdns>
JSON Response (output=json)
{
"query": {
"tool": "chinesefirewall_PRO",
"domain": "twitter.com"
},
"expectedresponse": "199.59.148.82 199.59.149.230 199.59.150.39",
"response": {
"detail": {
"server": [
{
"location": "Beijing",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Shenzen",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Inner Mongolia",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Heilongjiang Province",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Yunnan Province",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
}
]
},
"summary": {
"result": "not_visible",
"description": "No servers were able to reach your site on the correct IP address. This means that any URL's on this host are most likely NOT accessible from within mainland China."
}
},
"v2response": {
"dnsresults": {
"server": [
{
"location": "Beijing",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Shenzen",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Inner Mongolia",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Heilongjiang Province",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
},
{
"location": "Yunnan Province",
"resultvalue": "59.24.3.173",
"resultstatus": "fail"
}
],
"summary": "not_visible",
"description": "No servers were able to reach your site on the correct IP address. This means that any URL's on this host are most likely NOT accessible from within mainland China."
},
"httpresults": {
"detail": "Connection timed out.",
"summary": "error",
"description": "This URL appears to be blocked in China."
}
}
}
