Iran news API
Coverage about Iran from 1170 distinct publishers, in whatever language
it was reported. Pass country=IR to filter.
What coverage of Iran looks like
Coverage concentrates on regional politics, energy and sanctions. Publisher positions vary considerably, and international coverage about Iran heavily outweighs domestic reporting in the stream.
The media landscape
Domestic outlets differ considerably in editorial position, alongside a substantial layer of international coverage about the country that dominates an unscoped result. Energy and sanctions reporting carries specifics that international summaries drop; general coverage is heavily commentary-weighted.
Does this cover articles published in Iran, or about it?
About it. The country filter matches the places an article is about, so a wire
piece about Iran filed from London is in scope and a Iran outlet writing
about somewhere else is not. To filter by where the publisher is based, use
publisher_country instead, and combine the two when you want domestic
reporting about the domestic market.
How do I filter news to Iran?
Separate the two with publisher_country, or a query about Iran mostly returns what other countries are saying about it.
GET /search?country=IR&mode=hybrid&from=2026-07-24&limit=20Identifiers are FIPS 10-4, not ISO 3166 — why that matters.
What catches people out with Iran coverage?
International coverage about Iran substantially outweighs domestic reporting in an unscoped result set, so without publisher_country this filter mostly measures what other countries are saying. Domestic outlets differ considerably in position, and sanctions and energy coverage carries specifics that international summaries drop. Domestic and diaspora outlets both appear under this filter with sharply different editorial constraints, and separating them changes the character of the result set entirely. Energy reporting is the most factually dense material; political coverage carries a high proportion of commentary that a naive volume metric will count as reporting.
Recent coverage
Pulled from the index on 2026-07-31, in the language each was published in.
- Returning Afghans face growing risk of trafficking as crises deepen
- CENTCOM memo warns deployed troops phones may be confiscated over Iran data fears
- Middle East crisis: Humanitarian fallout 'worsening by the day' — Global Issues
- Group of climbers missing in avalanche in Pakistan, 4 bodies recovered
- House prices edge higher in July amid 'soft' market, says Nationwide
- Webster's retirement leads to packed race for his seat
- Analysts to Asharq Al-Awsat: Policy Flexibility Strengthens Saudi Arabia's Ability to Withstand Shocks
- Expletives and Exasperation Reportedly 'Erupted' Inside Trump's Meetings Over Iran War Deadlock
Which outlets cover Iran most?
The most active publisher on this country is globalsecurity.org at roughly
2% of the coverage, and the three busiest
— globalsecurity.org, haberler.com, cnfol.com — carry about 3% between them.
That share is worth reading before the volume figure: concentrated coverage
means a large result count can still be a small number of newsrooms. Combine
country with source to narrow to publishers you trust,
or with language to separate domestic reporting from international.
globalsecurity.org · haberler.com · cnfol.com · bankingnews.gr · inewsgr.com · jpost.com · ipna.ir · indiatimes.com · yle.fi · islamicinvitationturkey.com · zazoom.it · euronews.com · cnn.com · aol.co.uk
Cities with their own coverage
Places inside Iran that carry enough coverage to filter on individually,
using city.
city=Tehran— 420 articles, 283 outlets
What this market is best for
Best for energy, sanctions and regional diplomacy, with domestic specifics that international summaries omit. Weakest for anything requiring independent domestic scrutiny, and heavily diluted by international commentary unless publisher location is constrained.
Narrowing further
Two constraints do most of the work on this axis. Adding a language separates domestic reporting from international commentary about Iran, which an unscoped country query returns together. Adding a signal range with a lower bound narrows to articles written in a particular register — supply disruption, financial stress, conflict — rather than to articles that merely mention the subject.
# domestic-language coverage only
GET /search?country=IR&language=<iso639-3>&mode=hybrid
# supply-chain risk language, about this country
GET /search?country=IR&signal=signal_supply_disruption&signal_min=0.2Counts are provisional pending a snapshot taken against the API. Outlets and headlines are real.