get_performance

Instructions

Get performance (level: account|campaign|ad_group|ad). Aliases accepted: customerId, pageSize, pageToken, autoPaginate, maxPages, outputFormat.

Input Schema

Name	Required	Description	Default
`autoPaginate`	No	Alias of auto_paginate.
`auto_paginate`	No	fetch multiple pages automatically
`customerId`	No	Alias of customer_id.
`customer_id`	No	10-digit customer ID (no dashes). Optional.
`days`	No	Days back to query (1-365, default 30)
`filters`	No	optional performance filters
`level`	Yes	Aggregation level
`limit`	No	GAQL LIMIT (1-1000, default 50)
`maxPages`	No	Alias of max_pages.
`max_pages`	No	limit when auto_paginate=true (1-20)
`outputFormat`	No	Alias of output_format.
`output_format`	No	render format	table
`pageSize`	No	Alias of page_size.
`pageToken`	No	Alias of page_token.
`page_size`	No	optional page size (1-10000)
`page_token`	No	optional page token

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "autoPaginate": {
      "description": "Alias of auto_paginate.",
      "type": "boolean"
    },
    "auto_paginate": {
      "default": false,
      "description": "fetch multiple pages automatically",
      "type": "boolean"
    },
    "customerId": {
      "description": "Alias of customer_id.",
      "type": [
        "string",
        "number"
      ]
    },
    "customer_id": {
      "description": "10-digit customer ID (no dashes). Optional.",
      "type": "string"
    },
    "days": {
      "default": 30,
      "description": "Days back to query (1-365, default 30)",
      "type": "number"
    },
    "filters": {
      "additionalProperties": false,
      "description": "optional performance filters",
      "properties": {
        "campaignNameContains": {
          "description": "substring in campaign name (case sensitive)",
          "type": "string"
        },
        "minClicks": {
          "description": "minimum clicks (>=0)",
          "type": "number"
        },
        "minImpressions": {
          "description": "minimum impressions (>=0)",
          "type": "number"
        },
        "nameContains": {
          "description": "substring in entity name (case sensitive)",
          "type": "string"
        },
        "status": {
          "description": "e.g., ENABLED, PAUSED",
          "type": "string"
        }
      },
      "type": "object"
    },
    "level": {
      "description": "Aggregation level",
      "enum": [
        "account",
        "campaign",
        "ad_group",
        "ad"
      ],
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "GAQL LIMIT (1-1000, default 50)",
      "type": "number"
    },
    "maxPages": {
      "description": "Alias of max_pages.",
      "maximum": 20,
      "minimum": 1,
      "type": "number"
    },
    "max_pages": {
      "default": 5,
      "description": "limit when auto_paginate=true (1-20)",
      "maximum": 20,
      "minimum": 1,
      "type": "number"
    },
    "outputFormat": {
      "description": "Alias of output_format.",
      "enum": [
        "table",
        "json",
        "csv"
      ],
      "type": "string"
    },
    "output_format": {
      "default": "table",
      "description": "render format",
      "enum": [
        "table",
        "json",
        "csv"
      ],
      "type": "string"
    },
    "pageSize": {
      "description": "Alias of page_size.",
      "minimum": 1,
      "type": "number"
    },
    "pageToken": {
      "description": "Alias of page_token.",
      "type": "string"
    },
    "page_size": {
      "description": "optional page size (1-10000)",
      "minimum": 1,
      "type": "number"
    },
    "page_token": {
      "description": "optional page token",
      "type": "string"
    }
  },
  "required": [
    "level"
  ],
  "type": "object"
}

Google Ads MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Google Ads MCP Server

Related Tools

MCP directory API