---
id: eventregistry
version: "9.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# eventregistry — A package that can be used to query information in Event Registry (http://eventregistry.org/)

License: permissive · Maintenance: abandoned · Downloads: 115.7K/mo

## What it is and what it does

Event Registry is a Python client library for accessing the Event Registry news API, which aggregates articles and events from global news sources. It provides a query interface to search for news articles and events using a wide range of filters—keywords, named concepts (companies, people, places), news categories, sentiment scores, publication date ranges, source locations, and social media engagement metrics. The package handles API authentication, query construction, and result iteration, abstracting away direct HTTP calls to the underlying REST API.

The package is designed for researchers, data analysts, and developers who need programmatic access to structured news data. It supports both one-off queries and streaming feeds of new articles and events. However, the package is in abandoned maintenance status with no updates since June 2023, and it requires an API key obtained from the Event Registry service, which imposes both authentication overhead and potential rate limits or service availability concerns.

Use it for:

- Monitor news articles about specific companies or topics for sentiment analysis or trend tracking.
- Build a news aggregator that filters articles by location, category, and publication source.
- Research trending concepts and topics in the news over time using the trending API.
- Retrieve events related to keywords or concepts for event-driven data pipelines.
- Analyze social media engagement metrics for articles published by specific news sources.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Query news articles and events from Event Registry's API using filters like keywords, concepts, sentiment, location, date, and category.

Yes, if you need programmatic access to Event Registry's news data and can accept the abandoned maintenance status. The package is stable and has no known vulnerabilities, but verify that the Event Registry API service remains operational and that the package's Python 2.7 classifier does not reflect actual support limitations. High install friction and lack of recent updates are trade-offs for a specialized news API client.

## Install

pip install eventregistry
uv add eventregistry
poetry add eventregistry

## Installing eventregistry

Before you install: High install friction due to source distribution format. Package is in abandoned maintenance status with no updates since June 2023, though the repository remains active with 260 stars.

License in practice: MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects.

Quickstart:

pip install eventregistry

from eventregistry import EventRegistry, QueryArticlesIter
er = EventRegistry(apiKey="YOUR_API_KEY")
q = QueryArticlesIter(keywords="example")
for article in q.execQuery(er, maxItems=10):
    print(article)

Requires a free or paid API key from Event Registry (eventregistry.org) to authenticate queries.

Verify before relying:

- Whether the package works with Python versions beyond 2.7 despite classifiers listing only 2.7.
- Current status of the Event Registry API service and whether it remains operational.
- Whether the abandoned maintenance status affects API compatibility or introduces breaking changes.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 115.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

news article search api, event registry python client, query news by keywords and sentiment, trending topics in news, news filtering by location and category, news-api, event-detection, data-aggregation

[View on SkillFed](https://skillfed.io/packages/eventregistry) · [View on PyPI](https://pypi.org/project/eventregistry/)