supermetrics

# Supermetrics Marketing Data

Query marketing data from 100+ platforms including Google Analytics, Meta Ads, Google Ads, and LinkedIn.

## Usage

Import the helper module:

```python
from supermetrics import (
    discover_sources,
    discover_accounts,
    discover_fields,
    query_data,
    get_results,
    get_today,
    search,
    health,
)
```

## Functions

### discover_sources()

List all available marketing platforms.

```python
result = discover_sources()
for src in result['data']['sources']:
    print(f"{src['id']}: {src['name']}")
```

### discover_accounts(ds_id)

Get connected accounts for a data source.

**Common data source IDs:**
| ID | Platform |
|----|----------|
| FA | Meta Ads (Facebook) |
| AW | Google Ads |
| GAWA | Google Analytics |
| GA4 | Google Analytics 4 |
| LI | LinkedIn Ads |
| AC | Microsoft Advertising (Bing) |

```python
result = discover_accounts("GAWA")
for acc in result['data']['accounts']:
    print(f"{acc['account_id']}: {acc['account_name']}")
```

### discover_fields(ds_id, field_type=None)

Get available metrics and dimensions.

```python
# Get all fields
result = discover_fields("GAWA")

# Get only metrics
result = discover_fields("GAWA", "metric")

# Get only dimensions
result = discover_fields("GAWA", "dimension")
```

### query_data(...)

Execute a marketing data query. Returns schedule_id for async retrieval.

```python
result = query_data(
    ds_id="GAWA",
    ds_accounts="123456789",
    fields=["date", "sessions", "pageviews", "users"],
    date_range_type="last_7_days"
)
schedule_id = result['data']['schedule_id']
```

**Parameters:**
- `ds_id` (required): Data source ID
- `ds_accounts` (required): Account ID(s) from discover_accounts()
- `fields` (required): Field ID(s) from discover_fields()
- `date_range_type`: `last_7_days`, `last_30_days`, `last_3_months`, `custom`
- `start_date`, `end_date`: For custom date range (YYYY-MM-DD)
- `filters`: Filter expression (e.g., `"country == United States"`)
- `timezone`...