currentsapi-python

The official Python SDK for the Currents API.

Installation

Install the package from PyPI:

pip install currentsapi

Usage

Import the client and initialize it with your API key:

from currentsapi import CurrentsAPI

api = CurrentsAPI(api_key="YOUR_API_KEY")

Endpoints

Latest News

Retrieve the latest news headlines. Optionally filter by language:

api.latest_news()
api.latest_news(language="en")

Search

Search news articles with optional filters:

api.search(keywords="OpenAI", language="en")
api.search(country="US", category="technology", start_date="2024-01-01", end_date="2024-12-31")

Supported parameters:

• keywords – search keywords
• language – article language code
• country – country code
• category – news category
• start_date – start date (YYYY-MM-DD or datetime object)
• end_date – end date (YYYY-MM-DD or datetime object)

Available Resources

api.available_languages()
api.available_regions()
api.available_category()

Authentication

All requests are authenticated using an Authorization header. Pass your API key when instantiating the client:

api = CurrentsAPI(api_key="YOUR_API_KEY")

Get your API key at https://currentsapi.services/en/register.

License

MIT License