Iran News API

There are 70 news sources being monitored from Iran. Daily, over 478 news items are added.

The country code for Iran is ir. For every API endpoint that asks for source-country, just put ir to retrieve news from Iran. And the language code of Iran is en, use this two-letter code for the language parameter.

Historically, you can search news from Iran starting January 1st, 2022.



API Examples of how to work with news from Iran

Here are some examples how you can get breaking news, search by category, and get front pages for Iran. Be sure to check out the in-depth documentation as each API offers many different parameters to explore.

Get today's breaking news from Iran
source-country=ir
GET
https://api.worldnewsapi.com/top-news?source-country=ir
See the full documentation of how to get news headlines.
Get live news from Iran
source-country=ir
GET
https://api.worldnewsapi.com/search-news?source-country=ir
See the full documentation of how to search news.
Get news from Iran in the last week for the category politics
source-country=ir categories=politics
GET
https://api.worldnewsapi.com/search-news?source-country=ir&categories=politics
See the full documentation of how to search news by category.
Get front pages from news papers in Iran
source-country=ir date=2024-07-09
GET
https://api.worldnewsapi.com/retrieve-front-page?source-country=ir&date=2024-07-09
See the full documentation of how to get newspaper front pages.

If a news media outlet from Iran is missing, please reach out via our Discord or by email.

Looking for new from another country? Select a country from the list below:

Info

API Resources

Awesome APIs