linkedin run statistics report
linkedin_run_statistics_reportGenerate LinkedIn Ads statistics by cross-pivoting up to three dimensions in a single request. Easily analyze metrics by campaign vs. device or campaign group vs. serving location.
Instructions
Run a LinkedIn Ads report grouped by up to three pivots at once. This is the statistics finder, the only way to cross campaign with device, or campaign group with serving location, in a single request.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"adAccountId": "<adAccountId>",
"pivots": "<pivots>",
"startDate": "<startDate>"
},
"name": "linkedin_run_statistics_report"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pivots | Yes | One to three pivots. Order decides the order of pivotValues. | |
| endDate | No | Inclusive end, YYYY-MM-DD. Defaults to today. | |
| metrics | No | Metric keys from linkedin://metrics. Defaults to spend, impressions, clicks and the ratios. | |
| startDate | Yes | Inclusive start, YYYY-MM-DD. | |
| adAccountId | Yes | Selected LinkedIn advertising account, numeric ID. It must be listed in LINKEDIN_ADS_ACCOUNT_IDS. | |
| campaignIds | No | Restrict reporting to these campaign IDs or URNs in the selected account. | |
| creativeIds | No | Restrict reporting to these owned creative IDs. | |
| campaignType | No | Native campaign format filter. | |
| objectiveType | No | Native campaign objective filter. | |
| timeGranularity | No | Native reporting aggregation interval. Defaults to ALL. | |
| campaignGroupIds | No | Restrict reporting to these owned campaign-group IDs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text. Provider fields depend on the selected query. |