Data & API
All Great Firewall test data is open. Query any URL's verdict as JSON, or use the endpoints below.
Endpoints
| Endpoint | Description |
|---|---|
| /<url-path>/api | Verdict + 90-day stats for a URL |
| /api/verdict?path=https/facebook.com | Verdict + per-test history (JSON) |
| /api/search?q=facebook | Ranked search + related URLs |
| /api/domain?registrable=facebook.com | All tested hosts under a domain |
| /api/tags?status=blocked&kind=https | Browse URLs by mechanism, status and kind |
| /api/test?id=<id> | US/CN rows for one test |
| /api/ooni?id=<id> | The same test as OONI-style measurements |
| /feed.xml?list=…, /feed.json?list=… | Feeds: blocked, accessible, domains, tld |
| /random | Redirect to a random tested URL |
Methodology
Each URL is fetched from control (US) and in-country (CN) vantage points and reduced to one verdict: blocked, redirected to a Chinese site, contradictory, not blocked, or not enough data. The headline percentage is the share of conclusive tests blocked over the last 90 days. Read the full methodology →
Feeds
Recently tested — blocked · Recently tested — accessible · Most blocked sites (all time) · Blocked by TLD
Each feed is available as RSS (/feed.xml) and JSON Feed (/feed.json). Add &tld=cn to filter the TLD feed.
Browse and list pages are served from a snapshot generated 2026-07-30 05:16 UTC; individual URL pages are computed live.