news.un.org APInews.un.org ↗
Access UN News articles, headlines, topics, regions, and RSS feeds via 7 endpoints. Supports 8 languages with pagination and keyword search.
curl -X GET 'https://api.parse.bot/scraper/e8730028-f5ff-490e-8de8-95be80bd523c/get_homepage_headlines?lang=en' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch news headlines and featured stories from the UN News homepage for a specific language. Returns all visible stories including top stories, featured content, and editorial picks.
| Param | Type | Description |
|---|---|---|
| lang | string | Language code: en, ar, zh, fr, ru, es, pt, sw |
{
"type": "object",
"fields": {
"stories": "array of objects with title, url, summary, date, topic, region"
},
"sample": {
"data": {
"stories": [
{
"url": "https://news.un.org/en/story/2026/05/1167450",
"date": "",
"title": "Gaza flotilla: Aid delivery 'not a crime', UN rights office tells Israel",
"topic": "",
"region": "",
"summary": ""
},
{
"url": "https://news.un.org/en/story/2026/05/1167433",
"date": "",
"title": "WHO leads response to cruise ship hantavirus outbreak",
"topic": "Health",
"region": "",
"summary": ""
}
]
},
"status": "success"
}
}About the news.un.org API
The UN News API provides structured access to news.un.org across 7 endpoints, returning article content, headlines, topic feeds, regional filters, editorial sections, and RSS data. The get_story endpoint delivers full article body text, publication date, and associated topic and region arrays for any UN News URL. Coverage spans 8 languages including Arabic, Chinese, Swahili, and Portuguese, with 0-indexed pagination across topic and region result sets.
What the API returns
The API covers the main content surfaces of news.un.org. get_homepage_headlines returns the current front-page story list for a given lang code, with each item exposing title, url, summary, date, topic, and region. get_story accepts a full or relative UN News URL and returns the complete body text alongside topics and regions arrays, making it suitable for NLP pipelines or content aggregation. search_news accepts a query string and optional lang and page parameters, returning matching articles in the same story object shape.
Filtering by topic and region
get_topic_news filters by topic slug — values like human-rights, peace-and-security, climate-change, and humanitarian-aid — while get_region_news filters by region slug: africa, middle-east, europe, americas, asia-pacific, or global. Both endpoints return 10 articles per page using 0-indexed page parameters. Story objects from both endpoints carry the same six fields: title, url, summary, date, topic, and region.
Editorial sections and RSS
get_in_depth_section exposes four editorial section slugs — in-focus, interviews, features, and photo-stories — returning curated story lists per section in the standard story object shape. get_rss_feed accepts a full RSS feed URL matching the pattern https://news.un.org/feed/subscribe/{lang}/news/all/rss.xml and returns structured items with title, link, description, pubDate, and category fields. This endpoint is useful for polling freshness or tracking publication cadence across language editions.
- Monitor breaking UN News headlines by language using
get_homepage_headlineswith thelangparameter. - Build a climate-focused news digest by querying
get_topic_newswith theclimate-changetopic slug. - Extract full article text via
get_storyto feed summarization or entity-extraction models. - Track UN reporting on a specific geographic area using
get_region_newsfiltered by region slug such asafricaorasia-pacific. - Aggregate multilingual UN News content by iterating
get_rss_feedacross all eight supported language RSS URLs. - Surface in-depth UN journalism by fetching the
interviewsorfeaturessections fromget_in_depth_section. - Keyword-monitor UN communications on a specific issue using
search_newswith a targetedquerystring and paginating results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does UN News have an official developer API?+
What does `get_story` return beyond the headline?+
get_story returns the full body text of the article, the date of publication, the title, the canonical url, and two arrays: topics (e.g. 'Human Rights', 'Health') and regions (e.g. 'Africa', 'Europe'). It does not return author bylines or image URLs.How does pagination work across topic and region endpoints?+
get_topic_news and get_region_news use a 0-indexed page parameter and return 10 stories per page. Page 0 is the most recent set. The response echoes back the page value and the topic or region slug used in the request.Are author bylines or image URLs returned by any endpoint?+
title, url, summary, date, topic, and region; get_story adds body, topics, and regions. Author attribution and image assets are not included. You can fork this API on Parse and revise it to add those fields if the source exposes them.