Insights Tools

Tools for retrieving Google Ads performance metrics. The get_insights tool supports four reporting levels (customer, campaign, ad group, ad), a configurable metric list, and optional segment breakdowns.

get_insights

Retrieve Google Ads performance metrics at a chosen reporting level. Requires a date range. Returns the requested metrics with optional segment breakdowns. Values stored in micros (cost, average CPC, average CPM) are also returned converted to the account's currency.

Parameters

Supported metrics

Pass any subset as metrics:

impressions, clicks, cost_micros, conversions, conversions_value, ctr, average_cpc, average_cpm, all_conversions, all_conversions_value, view_through_conversions, video_views, engagements

Supported segments

Pass any subset as segments to break down rows:

date, device, day_of_week, ad_network_type, click_type, geo_target_country, hour, month, week, quarter, year

Examples

What's my Google Ads spend and conversions for the last 30 days?

Top 10 campaigns by ROAS in customer 123-456-7890 last month

Daily impressions and clicks per device for campaign 22334455 in November

{
  "tool": "get_insights",
  "arguments": {
    "customer_id": "123-456-7890",
    "level": "customer",
    "date_range": {
      "start_date": "2026-04-01",
      "end_date": "2026-04-30"
    },
    "metrics": ["impressions", "clicks", "cost_micros", "conversions"]
  }
}

{
  "tool": "get_insights",
  "arguments": {
    "customer_id": "123-456-7890",
    "level": "campaign",
    "date_range": {
      "start_date": "2026-04-01",
      "end_date": "2026-04-30"
    },
    "metrics": ["cost_micros", "conversions", "conversions_value"],
    "order_by_metric": "conversions_value",
    "order_desc": true,
    "limit": 10
  }
}

{
  "tool": "get_insights",
  "arguments": {
    "customer_id": "123-456-7890",
    "level": "ad_group",
    "date_range": {
      "start_date": "2026-04-01",
      "end_date": "2026-04-07"
    },
    "metrics": ["impressions", "clicks", "ctr"],
    "segments": ["date", "device"],
    "campaign_ids": ["22334455"]
  }
}

Response

Returns a list of metric rows. Cost-related fields are returned both as micros (raw API value) and as the account's currency (converted). Segments selected via segments appear as additional fields on each row.

Related