Get historical metrics for a store over a date range. Use get_metrics_dictionary first to see available metrics.

Key Features:

• Time-series data by day/week/month
• Fetch all metrics or select specific ones
• Flexible date range with last_x_days or absolute dates
• Contains historical data through yesterday only (not today)

Parameters:

• store_id (integer, required): Store identifier
• last_x_days (integer, optional): Get metrics for the last X days ending yesterday (minimum: 1, e.g., 1=yesterday only, 30=last 30 days). Alternative to using start_date/end_date.
• start_date (string, optional): Start date (YYYY-MM-DD, inclusive). Use with end_date or use last_x_days instead.
• end_date (string, optional): End date (YYYY-MM-DD, inclusive, max: yesterday). Use with start_date or use last_x_days instead.
• metrics (string, optional): Comma-separated metric keys (empty = all metrics)
• interval (string, optional): Grouping interval - "day", "week", or "month" (default: "day")

Usage Patterns:

"Show me sales and orders for last 30 days"
→ last_x_days=30, metrics="tot_cv,tot_orders"

"Get all metrics for November 2025"
→ start_date="2025-11-01", end_date="2025-11-30"

"Weekly ROAS trend for last quarter"
→ last_x_days=90, metrics="blended_roas", interval="week"

"Yesterday's metrics only"
→ last_x_days=1

Response Structure:

{
  "_fields": {"tot_cv": "Total Sales", "tot_orders": "# of Orders"},
  "store_id": 1,
  "store_name": "..."
}