Build on the evidence.

Is a domain blocked in a country? Returns status (blocked / accessible / unknown), basis, the evidence count, the blocking method, a heuristic confidence (not a calibrated probability) and measurementSource. A measured verdict comes from per-domain OONI + CensoredPlanet evidence behind POST /v1/accessibility/batch. That source is on hold during source review (HTTP 503 ACCESSIBILITY_REVIEW_HOLD), so no domain is measured now: a domain on the static known-blocked list returns status: "blocked" with basis: "known_list" and a fixed confidence of 0.7, and every other domain returns status: "unknown". Verifying many domains? Use POST /hydra/v1/detect/batch (up to 50 per call). Requires an API key (free — get one at /api-keys/signup;hydra_demo_key also works for testing).

Request Body

Response Schema

Verify many domains in one country in a single call — up to 50 domains per request. Each result carries the same status / basis semantics as /hydra/v1/detect, plus a summary of blocked / accessible / unknown counts. Built for bulk verification jobs (checking hundreds of domains across countries). Requires an API key.

Request Body

{
  "country": "IR",
  "targets": ["twitter.com", "whatsapp.com", "github.com"]
}

Response

{
  "country": "IR",
  "count": 3,
  "summary": { "blocked": 2, "accessible": 0, "unknown": 1 },
  "results": [
    { "target": "twitter.com",  "status": "blocked", "blocked": true,  "basis": "measured",   "methods": ["tcp-reset"] },
    { "target": "whatsapp.com",  "status": "blocked", "blocked": true,  "basis": "measured",   "methods": ["tcp-reset"] },
    { "target": "github.com",    "status": "unknown", "blocked": false, "basis": "unmeasured", "methods": [] }
  ]
}

Experimental heuristic, not a validated prediction; no accuracy claim. currentRisk is the country's live OONI anomaly rate (a fixed fallback score when live data is missing). predictedRisk equals currentRisk and trend is always "stable": no trend or onset model runs, so onset timing is unproven, and horizon is echoed. The same input gives the same output. With a target, mlPrediction adds a per-domain blocked probability from the ML service or a local rule; mlPrediction.source says which.

Request Body

curl -X POST https://api.voidly.ai/hydra/v1/predict \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hydra_demo_key" \
  -d '{"country":"RU","horizon":30}'

Experimental 7-day current-regime risk score for a country, from a model trained on historical censorship patterns, election calendars and political events. Onset timing is unproven: a score is not a prediction of when a shutdown starts, and no current skill or accuracy figure is published. Limits: /v1/forecast/onset-skill.

Response Fields

# Get 7-day forecast for Iran
curl "https://api.voidly.ai/v1/forecast/IR/7day"

# Get all high-risk countries (threshold 0.3)
curl "https://api.voidly.ai/v1/forecast/high-risk?threshold=0.3"

# Batch forecast for multiple countries
curl -X POST "https://api.voidly.ai/v1/forecast/batch" \
  -H "Content-Type: application/json" \
  -d '{"countries":["IR","CN","RU"]}'

Example Response

{
  "country": "IR",
  "country_name": "Iran",
  "forecast": [
    {"day": 0, "date": "2026-02-10", "risk": 0.26, "drivers": []},
    {"day": 1, "date": "2026-02-11", "risk": 0.28, "drivers": []},
    {"day": 7, "date": "2026-02-17", "risk": 0.35, "drivers": ["election"]}
  ],
  "summary": {
    "max_risk": 0.35,
    "max_risk_day": 7,
    "avg_risk": 0.27,
    "key_drivers": ["election"]
  },
  "confidence": 0.85,
  "model_version": "v1"
}

Country threat level: the live OONI anomaly rate, raised to a static floor for the country's risk tier (scoreSource says which). recentBlocks counts OONI measurements with confirmed blocking in the upstream window, or is null without live data. No trend is computed, so trend is null. With includeHistory=true, history counts incident records per day (each day's score is null), or is null when the incident source does not answer. Not a validated prediction.

curl -H "X-API-Key: hydra_demo_key" \
  "https://api.voidly.ai/hydra/v1/threat-level/IR?includeHistory=true"

Get censorship scores for all tracked countries, sorted by severity.

Query Parameters

Full censorship index dataset with Schema.org structured data. Updated continuously.

Detailed censorship data for a single country.

curl "https://api.voidly.ai/data/country/CN"

Censorship Intelligence — one-call state of global censorship: countries measured, countries with confirmed national blocks, the deepest censor, the broadest-blocked category, measurement depth and data coverage. The ideal first call; links the per-metric endpoints below.

curl "https://api.voidly.ai/v1/measurement/summary"

What each censor targets: per-country category mix of nationally-blocked domains, rolled into three focus shares — political speech, regulated “morality”, and circumvention tooling. Add ?country=XX for one country.

curl "https://api.voidly.ai/v1/measurement/intent-profile?country=RU"

Which countries most censor a given Citizen Lab content category (NEWS, ANON, HUMR, LGBT, GMB, POLR…), ranked by distinct domains nationally blocked, with example domains.

curl "https://api.voidly.ai/v1/measurement/category-leaders?category=LGBT"

Country pairs that nationally block the same domains (“censorship twins”) — shared blocklist size plus shared_political and shared_tooling, which separate political and circumvention categories from other shared domains. Read the response for the observed counts and window.

curl "https://api.voidly.ai/v1/measurement/co-blocking"

Global leaderboard of the most-blocked domains by country count. Honest: gambling/adult dominate the top (legal blocking), not political censorship — use ?category=ANON for circumvention tools or ?category=NEWS for news. Also: /network-depth, /quality, /techniques, /by-region.

curl "https://api.voidly.ai/v1/measurement/most-blocked-domains?category=ANON"

Check which VPN endpoints are blocked in each country. Voidly combines probe-network reachability checks with censorship intelligence. Per-probe and operator listings are withheld to protect volunteer operators.

Query Parameters

curl "https://api.voidly.ai/v1/vpn-accessibility?country=IR"

Platform Risk Scores

Per-platform censorship risk across all monitored countries. How blocked is WhatsApp globally?

Under review. These routes currently answer HTTP 200 with every blocked verdict, list, count and rate set to unknown or null and a top-level review object (status: "under_review", dataAsOf). These verdicts counted CensoredPlanet rows and IODA outages as blocks, which Voidly no longer accepts as block evidence, so they are withheld until a fixed checker passes review. Why ↗

curl https://api.voidly.ai/v1/platforms/scores

Platforms tracked: Twitter/X, WhatsApp, Telegram, YouTube, Signal, Facebook, Instagram, TikTok, Wikipedia, Tor, Reddit, Medium.Explore live →

ISP Risk Index

Composite ISP censorship scores measuring aggressiveness, category breadth, and blocking methods.

Under review. These routes currently answer HTTP 200 with every blocked verdict, list, count and rate set to unknown or null and a top-level review object (status: "under_review", dataAsOf). These verdicts counted CensoredPlanet rows and IODA outages as blocks, which Voidly no longer accepts as block evidence, so they are withheld until a fixed checker passes review. Why ↗

curl "https://api.voidly.ai/v1/isp/index?country=IR"

Composite score (0-100) based on block rate, method aggressiveness, and category breadth.Explore live →

Service Accessibility API — on hold

Accessibility checks are on hold during source review. All four endpoints below return HTTP 503 with code ACCESSIBILITY_REVIEW_HOLD.

{
  "error": "Accessibility checks temporarily unavailable",
  "code": "ACCESSIBILITY_REVIEW_HOLD"
}

The paths remain reference only while the hold is active. A withheld response is not an accessibility verdict.Read public incident totals →

List Incidents

# List incidents for Iran, limit 10
curl "https://api.voidly.ai/data/incidents?country=IR&limit=10"

Incident Detail

Lookup by human-readable ID (IR-2026-0142) or hash ID. Both formats work interchangeably.

curl "https://api.voidly.ai/data/incidents/IR-2026-0142"

Evidence Permalinks

Get verifiable evidence sources (OONI, IODA, CensoredPlanet measurements) for an incident.

curl "https://api.voidly.ai/data/incidents/IR-2026-0142/evidence"

Register & Submit

pip install voidly-probe

Subscribe

curl -X POST "https://api.voidly.ai/api/alerts/subscribe" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"country_code":"IR","min_severity":"high","webhook_url":"https://your-server.com/webhook"}'

Webhook Payload

{
  "event": "incident.created",
  "timestamp": "2026-02-10T12:00:00Z",
  "incident": {
    "id": "abc123",
    "hashId": "IR-2026-0142",
    "country": "IR",
    "title": "DNS blocking of twitter.com",
    "severity": "high",
    "confidence": 0.95
  }
}

Signed with X-Voidly-Signature: sha256=... (HMAC-SHA256). Retry: 2, 4, 8, 16, 32 min.