v1.2.0CC BY 4.0

Censorship Intelligence API

Real-time global censorship detection powered by 12.5M+ measurements across 50 countries. 99.8% accuracy. Free for research.

12.5M+

Measurements

Countries

99.8%

ML Accuracy

4,481

Incidents

Get Started Try Playground Open Data

Quickstart

Check if Google is blocked in China with a single request. No signup required.

bash

"text-green-400">curl "text-purple-400">-X POST https://api.voidly.ai/hydra/v1/detect \
  "text-purple-400">-H "Content">-Type: application/json" \
  "text-purple-400">-H "X">-API">-Key: hydra_demo_key" \
  -d '{"country":"CN","target":"google.com"}'

Response

json

{
  "country": "CN",
  "target": "google.com",
  "blocked": true,
  "confidence": 0.95,
  "blockType": "dpi_block",
  "lastChecked": "2026-02-06T12:00:00Z",
  "sources": ["ooni", "sensor", "telemetry"]
}

Authentication

Pass your API key in the X-API-Key header. Public data endpoints require no authentication.

Demo API KeyNo Signup

Use this key for testing. Rate limited to 100 requests/minute.

Request Headers

Header	Value	Required
`X-API-Key`	Your API key	For /hydra/* endpoints
`Content-Type`	application/json	For POST requests

Endpoints

POST/hydra/v1/detect

Check if a domain is actively blocked in a country. Returns block status, confidence, and detection method.

Try It

Country

Target

Request Body

Field	Type	Description
`country`	string	ISO 3166-1 alpha-2 code (e.g., "CN", "IR")
`target`	string	Domain to check (e.g., "google.com")
`includeISPs`	boolean	Include per-ISP breakdown (optional)

Response Schema

Field	Type	Description
`blocked`	boolean	Whether target is blocked
`confidence`	number	ML model confidence (0-1)
`blockType`	string	"dpi_block" \| "dns_block" \| "ip_block" \| "none"
`sources`	string[]	Data sources used: "ooni", "sensor", "telemetry"
`lastChecked`	string	ISO 8601 timestamp

POST/hydra/v1/predict

Predict future censorship risk for a country using the ML model. Returns trend and contributing factors.

Request Body

Field	Type	Description
`country`	string	ISO 3166-1 alpha-2 code
`target`	string?	Optional domain to predict risk for
`horizon`	number	Prediction horizon in days (default: 7)

bash

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

GET/hydra/v1/threat-level/:country

Get the current threat level for a country with recommendations and optional 30-day history.

bash

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

GET/hydra/v1/scores

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

Query Parameters

Param	Type	Description
`minConfidence`	number	Minimum confidence threshold (0-1, default: 0.5)
`limit`	number	Max results (default: 50)

GET/hydra/v1/model/info

Get ML model metadata including version, accuracy metrics, and training details.

bash

"text-green-400">curl "text-purple-400">-H "X">-API">-Key: hydra_demo_key" "https://api.voidly.ai/hydra/v1/model/info"

Public Data

Open datasets available without authentication. Licensed under CC BY 4.0.

GET/data/censorship-index.jsonNo Auth

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

JSON CSV

GET/data/country/:codeNo Auth

Detailed censorship data for a single country.

bash

"text-green-400">curl "https://api.voidly.ai/data/country/CN"

GET/data/methodologyNo Auth

Machine-readable methodology including scoring algorithm and data sources.

Errors

The API uses standard HTTP status codes. All errors return JSON with error and message fields.

Code	Name	Resolution
`400`	Bad Request	Invalid request parameters. Check country codes (ISO 3166-1 alpha-2) and required fields.
`401`	Unauthorized	Invalid or missing API key. Include X-API-Key header.
`404`	Not Found	Country or resource not found. Check the country code exists in our dataset.
`429`	Rate Limited	Too many requests. Wait 60 seconds and retry with exponential backoff.
`500`	Server Error	Internal error. Retry with backoff. If persistent, contact support.
`503`	Service Unavailable	API temporarily unavailable. Check status page.

Error Response Format

json

{
  "error": "BAD_REQUEST",
  "message": "country and target are required"
}

Rate Limits

API requests are rate limited to ensure fair usage. Limits vary by endpoint and key type.

Key Type	Rate Limit	Burst
Demo Key	100 requests/minute	20 requests
Research Key	1,000 requests/minute	100 requests
Public Data	No limit	—

Rate Limit Headers

Header	Description
`X-RateLimit-Limit`	Maximum requests per window
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when window resets