src.data.providers.base

Abstract base class for data providers.

Module Contents

class src.data.providers.base.DataProvider

Bases: abc.ABC

Abstract base class for trend data providers.

abstractmethod fetch_trends(queries: List[str], geo: str, date_range: str, **kwargs) → Dict[str, Any]

Fetch trend data for given queries.

Parameters:

• queries – List of search queries

• geo – Geographic region code

• date_range – Date range specification

• **kwargs – Additional provider-specific parameters

Returns:

Raw trend data dictionary

Raises:

APIError – If API request fails

abstractmethod validate_connection() → bool

Validate API connection and credentials.

Returns:

True if connection is valid

Raises:

APIError – If validation fails