sportnews-api 0.1.5

Official Python SDK for the SportNews API - Access sports news in real time

SportNews API SDK

An official Python SDK for the SportNews API, providing streamlined access to real-time sports news. This library allows developers to easily integrate sports news feeds into their Python applications.

Installation

pip install sportnews-api

Usage

from sportnews import SportNewsAPI

# Initialize the client with your API key
api = SportNewsAPI('YOUR_API_KEY')

# Retrieve the latest news
news = api.get_latest_news(
    limit=10,
    language='en'
)

# Display an article
article = news[0]
print(f"Title: {article.title}")
print(f"Date: {article.published}")
print(f"Description: {article.description}")
print(f"Sport: {article.sport}")

Searching for Articles

# Search for articles about football from the last 7 days
from datetime import datetime, timedelta

search_results = api.search_news(
    query="football",
    from_date=datetime.utcnow() - timedelta(days=7),
    language="en",
    size=5
)

for article in search_results['items']:
    print(f"Title: {article.title} | Published: {article.published}")

Key Features

• Retrieve the latest sports news
• Search articles with advanced filters
• Multilingual support (FR, EN, ES, IT, DE)
• Pagination of results
• Robust error handling
• Automatic parameter validation
• Date-based search for temporal filtering

NewsArticle Object

Each news article returned by the API has the following attributes:

• title (str): The title of the article.
• published (datetime): The publication date.
• description (str): A brief summary of the article.
• sport (str): The sport associated with the article.
• language (str): The language of the article.

Error Handling

The SDK raises a SportNewsAPIError for any issues during API requests. Make sure to handle these exceptions in your application:

from sportnews import SportNewsAPI, SportNewsAPIError

try:
    news = api.get_latest_news(language='fr')
except SportNewsAPIError as e:
    print(f"An error occurred: {e}")

Supported Languages

• French (fr)
• English (en)
• Spanish (es)
• Italian (it)
• German (de)

License

This project is licensed under the MIT License.

Running Tests

The SDK includes a suite of unit tests to validate its functionality. Run the following command to execute the tests:

python -m unittest discover tests

Support

• Documentation: https://docs.sportnews-api.com
• Support email: [e-mail]

Developed and maintained by the SportNews API team.