UN APInews.un.org ↗

"""UN News API — browse headlines, search, drill into articles, filter by topic/region."""
from parse_apis.un_news_api import UNNews, Topic, Region, Section, Language, StoryNotFound

client = UNNews()

# Browse today's homepage headlines (single page, capped)
for story in client.stories.homepage(lang=Language.EN, limit=5):
    print(story.title, story.url)

# Search for a keyword and take the first result
result = client.stories.search(query="humanitarian", limit=1).first()
if result:
    print(result.title, result.date, result.summary)

# Drill into the full article for that story
try:
    article = client.articles.get(url=result.url)
    print(article.title, article.date)
    print(article.body[:200])
    print(article.topics, article.regions)
except StoryNotFound as exc:
    print(f"Article gone: {exc}")

# Browse climate-change topic stories
climate = client.topicfeed(slug=Topic.CLIMATE_CHANGE)
for story in climate.stories(lang=Language.EN, limit=3):
    print(story.title, story.date, story.summary)

# Browse Africa region news
africa = client.regionfeed(slug=Region.AFRICA)
for story in africa.stories(limit=3):
    print(story.title, story.date)

# Get editorial features section
for story in client.stories.in_depth(section=Section.FEATURES, limit=3):
    print(story.title, story.url)

# Get RSS feed items
for item in client.feeditems.feed(limit=3):
    print(item.title, item.pub_date, item.link)

print("exercised: stories.homepage / stories.search / articles.get / topicfeed.stories / regionfeed.stories / stories.in_depth / feeditems.feed")