Everything this site shows is readable as data. The API is open, needs no key, and is the same one the dashboard uses.
Put this on your site Live widgets other sites, channels and READMEs can carry. Every one is served from this site, updates itself, and needs nothing installed on your page.
Embed on a page Share a picture or a message
1 Choose a widgetOverall status
Status panel iframe International-gateway reachability, services reachable and open incidents. Sits in an iframe on any website. Status badge image An image. Works anywhere an image does — a web page, a README, a forum post, an email signature. README badge image The small flat badge a README is built from, in the shape other build-status badges use. Reachability strip image One cell per interval over the window you choose — the uptime bar every status page uses. Disruption alert strip iframe Appears only while a national disruption is active, and is blank the rest of the time. Made to live in a page header.
One service or network
Service badge image One service, its verdict and when it was last probed, as an image. Service card iframe One service in detail: verdict, the networks that could reach it, and seven days of hourly probes. “Is it blocked?” box iframe A search box your visitors can type into without leaving your page. Network badge image One Iranian network: whether it answered, how fast, and when it was checked. Network grid iframe Every monitored Iranian network, one row each.
Incidents
Latest incident iframe Always shows the newest open incident, so a sidebar never goes stale. Incident list iframe The last few incidents, each linking to its own permanent page. One incident iframe A single incident by number — the thing to put in an article instead of a screenshot. Date range timeline iframe A fixed window of incidents, day by day. Frozen to the dates you pick, so an article never drifts. Year heatmap image A year of disruption, one cell per day. Built for annual reports and anniversary coverage.
Context
Tor demand badge image Bridge users from Iran, with a sparkline — the clearest signal of what blocking does to people. Freedom score card iframe Freedom House and RSF scores for Iran. Changes once a year, so it is the one embed that can be cached for a day. Other ways in iframe Onion address, mirrors and the incident feed — for readers who cannot reach iranblock.com.
3 Copy and pastePreview
Exactly what your visitors will see, on a background matching the theme you picked. It updates itself every five minutes.
HTML
<iframe src="https://iranblock.com/embed?lang=en&theme=dark" title="Iran internet status — IranBlock" width="340" height="186" style="border:0;color-scheme:dark" loading="lazy"></iframe>Paste it into your page’s HTML wherever the widget should appear. No script, no plugin, nothing else to install.
Read API — 126 endpoints All endpoints are GET, return JSON, and are served under /api/v1. Responses carry Cache-Control, so polling more often than the stated max-age gains nothing.
API reference — OpenAPI 3.1 1
Access briefing and evidence 8 ?days · ?source · ?since · ?until · ?asn · ?domain
/api/v1/destination?domain=telegram.org&days=30/api/v1/outcomes?source=cp:HTTPS&days=30
Google traffic — Transparency Report 4 ?products · ?from · ?to
/api/v1/google/traffic?products=19,6,21/api/v1/google/daily?from=2019-11-01&to=2019-11-30
Live check from inside Iran 3 ?target · ?asn
/api/v1/live/probe?target=www.iranintl.com&asn=44244
APNIC — ISP address-space share 1
ArvanCloud monitoring 2 /api/v1/arvancloud/latest/api/v1/arvancloud/monitoring
Baselines — every reading against its own 30-day median 1
BGP.tools prefixes 2 /api/v1/bgptools/prefixes
Published blocklists and the open lookup (dated snapshots, not live) 8 ?q · ?domain · ?ip · ?asn · ?limit
/api/v1/blocklists/lookup?q=torproject.org/api/v1/blocklists/lookup?q=5.160.0.1/api/v1/blocklists/sources/api/v1/blocklists/categories/api/v1/blocklists/suffixes/api/v1/blocklists/asn-coverage
Cloudflare Radar 4 ?days · ?metric
/api/v1/cloudflare/traffic/api/v1/cloudflare/quality/api/v1/cloudflare/status/api/v1/cloudflare/top-domains
Direct connectivity probes 9 ?hours · ?service · ?days
/api/v1/connectivity/services/api/v1/connectivity/response-times/api/v1/connectivity/history/api/v1/connectivity/ooni-history?service=Instagram&days=30/api/v1/connectivity/verdicts?q=instagram.com/api/v1/vantage?service=Instagram&days=30/api/v1/vantage/strategies?days=7/api/v1/connectivity/service-categories/api/v1/connectivity/recent-changes
Disruption patterns 9 ?days · ?limit
/api/v1/disruptions/frequency/api/v1/disruptions/service-heatmap/api/v1/disruptions/timeline/api/v1/disruptions/correlation/api/v1/disruptions/protocol-impact/api/v1/disruptions/duration/api/v1/disruptions/isp-frequency/api/v1/disruptions/monthly-heatmap/api/v1/disruptions/patterns/connectivity
DPI & throttling 13 /api/v1/dpi/throttling-signal/api/v1/dpi/protocol-analysis/api/v1/dpi/http-versions/api/v1/dpi/incident-heatmap/api/v1/dpi/temporal-pattern/api/v1/dpi/injectors?days=90/api/v1/dpi/dns-protocols/api/v1/dpi/quality-history
Bulk exports 6 ?days · ?metric
/api/v1/exports/incidents.json/api/v1/exports/incidents.csv/api/v1/exports/source-freshness.json/api/v1/exports/source-freshness.csv/api/v1/exports/scores.json/api/v1/exports/timeseries.csv
Events — corroborated, derived from the signals 2 ?days
Internet freedom scores 2 /api/v1/freedom/isoc-resilience
IHR — internet chokepoints 3 /api/v1/ihr/top-chokepoints
Incidents 7 ?before · ?day · ?days · ?limit · ?offset · ?source · ?type
/api/v1/incidents/:id/evidence/api/v1/incidents/summary/api/v1/incidents/velocity
Mobile carriers & eSIM 2 /api/v1/mobile/esim-providers
OONI measurements 8 ?category · ?days · ?limit · ?test
/api/v1/ooni/domains/changes?days=7/api/v1/ooni/test-list/stats/api/v1/ooni/blocking-methods
Resources 3 /api/v1/resources/access-now
BGP routing 9 ?days · ?hours · ?prefix
/api/v1/routing/asn-explorer/api/v1/routing/bgp-history/api/v1/routing/bgp-updates/api/v1/routing/bgp-events/api/v1/routing/prefix-history/api/v1/routing/bgp-stream/api/v1/routing/ripe-probes
Daily snapshot — canonical JSON with SHA-256 2 /api/v1/snapshot/daily.json/api/v1/snapshot/daily.sha256
Live status & source freshness 4 /api/v1/status/sources/historyThe data is gathered from independent public sources — OONI, IODA, Cloudflare Radar, Tor Metrics, RIPE Atlas and others — and republished here. Use it freely; cite IranBlock and link the incident URL so readers can verify what you report. How these numbers are produced →
