# linkedin_run_statistics_report

> Run a LinkedIn Ads report grouped by up to three pivots at once. One of 25 LinkedIn Ads tools on the Get MCP Ads MCP gateway.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [LinkedIn Ads](https://www.getmcpads.com/docs/sources/linkedin-ads)

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.

> **Note** Advertising API Development tier. Test-account writes only; Standard access is not yet approved.

|  |  |
| --- | --- |
| Source | [LinkedIn Ads](https://www.getmcpads.com/docs/sources/linkedin-ads) |
| Kind | Read |
| Discovery | Reachable through `search_tools` and `run_tool` |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/linkedin-ads/mcp |

## Parameters

| Name | Type | Required | Notes |
| --- | --- | --- | --- |
| `adAccountId` | string | Required | Selected LinkedIn advertising account, numeric ID. |
| `campaignIds` | array | Optional | campaignIds. |
| `campaignGroupIds` | array | Optional | Restrict reporting to these owned campaign-group IDs. |
| `creativeIds` | array | Optional | Restrict reporting to these owned creative IDs. |
| `pivots` | array | Required | One to three pivots. Order decides the order of pivotValues. |
| `startDate` | string | Required | startDate. |
| `endDate` | string | Optional | endDate. |
| `timeGranularity` | string | Optional | Native reporting aggregation interval. One of: `ALL`, `DAILY`, `MONTHLY`, `YEARLY`. |
| `metrics` | array | Optional | metrics. |
| `campaignType` | string | Optional | Native campaign format filter. One of: `TEXT_AD`, `SPONSORED_UPDATES`, `SPONSORED_INMAILS`, `DYNAMIC`. |
| `objectiveType` | string | Optional | Native objective; must be compatible with the campaign type and ad format. One of: `LEAD_GENERATION`, `CREATIVE_ENGAGEMENT`, `WEBSITE_TRAFFIC`, `VIDEO_VIEW`, `BRAND_AWARENESS`, `WEBSITE_CONVERSION`, `WEBSITE_VISIT`, `ENGAGEMENT`, `JOB_APPLICANT`. |

## Calling it

Through run_tool, since it is not announced

```json
{
  "name": "run_tool",
  "arguments": {
    "name": "linkedin_run_statistics_report",
    "args": {
      "adAccountId": "<string>",
      "pivots": "<array>",
      "startDate": "<string>"
    }
  }
}
```

- [LinkedIn Ads metrics](https://www.getmcpads.com/docs/sources/linkedin-ads/metrics): What you can ask for.
- [LinkedIn Ads dimensions](https://www.getmcpads.com/docs/sources/linkedin-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/linkedin-ads/tools/linkedin_run_statistics_report
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.