get_performance
Retrieve Google Ads performance data at account, campaign, ad group, or ad level with customizable filters, date ranges, and output formats for analysis.
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"
}