# linkedin_get_insights

> Run a LinkedIn Ads report grouped by one pivot. 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 one pivot. This is the analytics finder: one pivot, any granularity, and up to 20 fields including dateRange and pivotValues. Ratios such as CTR, CPC and CPM do not exist in the API and are computed here from the raw terms.

> **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 | Announced in the tool list |
| 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. |
| `pivot` | string | Optional | Grouping. Defaults to CAMPAIGN. One of: ACCOUNT, CAMPAIGN_GROUP, CAMPAIGN, CREATIVE, COMPANY, SHARE, CONVERSION, MEMBER_COMPANY, MEMBER_COMPANY_SIZE, MEMBER_INDUSTRY, MEMBER_SENIORITY, MEMBER_JOB_TITLE, MEMBER_JOB_FUNCTION, MEMBER_COUNTRY_V2, MEMBER_REGION_V2, MEMBER_COUNTY, SERVING_LOCATION, PLACEMENT_NAME, IMPRESSION_DEVICE_TYPE, EVENT_STAGE, CARD_INDEX, CONVERSATION_NODE, CONVERSATION_NODE_OPTION_INDEX. |
| `startDate` | string | Required | Inclusive start, YYYY-MM-DD. |
| `endDate` | string | Optional | Inclusive end, YYYY-MM-DD. Defaults to today. |
| `timeGranularity` | string | Optional | Defaults to ALL, one row for the whole range. One of: `ALL`, `DAILY`, `MONTHLY`, `YEARLY`. |
| `metrics` | array | Optional | Metric keys from linkedin://metrics. Defaults to spend, impressions, clicks and the ratios. |
| `campaignType` | string | Optional | Native campaign format filter. One of: `TEXT_AD`, `SPONSORED_UPDATES`, `SPONSORED_INMAILS`, `DYNAMIC`. |
| `sortField` | string | Optional | Native field used to order the returned campaign page. One of: `COST_IN_LOCAL_CURRENCY`, `IMPRESSIONS`, `CLICKS`, `ONE_CLICK_LEADS`, `OPENS`, `SENDS`, `EXTERNAL_WEBSITE_CONVERSIONS`. |
| `sortOrder` | string | Optional | Ascending or descending native result ordering. One of: `ASCENDING`, `DESCENDING`. |

## Calling it

Directly, since it is announced

```json
{
  "name": "linkedin_get_insights",
  "arguments": {
    "adAccountId": "<string>",
    "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_get_insights
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.