linkedin_ads_analytics
Query LinkedIn ad performance by custom pivot, metrics, date range, and filters to break down demographics, devices, campaigns, or creatives.
Instructions
Flexible analytics query with custom pivot, fields, and filters. Use for demographic breakdowns, device splits, creative performance, etc.
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": {
"start_date": "<start_date>",
"end_date": "<end_date>",
"pivot": "<pivot>"
},
"name": "linkedin_ads_analytics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pivot | Yes | Pivot dimension: ACCOUNT, CAMPAIGN_GROUP, CAMPAIGN, CREATIVE, MEMBER_COMPANY_SIZE, MEMBER_INDUSTRY, MEMBER_SENIORITY, MEMBER_JOB_FUNCTION, MEMBER_COUNTRY_V2, IMPRESSION_DEVICE_TYPE, etc. | |
| fields | No | Metrics to return. Default: impressions, clicks, costInLocalCurrency, landingPageClicks, oneClickLeads, oneClickLeadFormOpens, externalWebsiteConversions, externalWebsitePostClickConversions, totalEngagements, videoViews, videoCompletions, approximateMemberReach, dateRange, pivotValues. The server adds a derived `frequency` field (impressions / approximateMemberReach) when both are non-zero. Reach is only populated at pivots CAMPAIGN, CREATIVE, and CAMPAIGN_GROUP — it returns 0 at pivot=ACCOUNT. | |
| end_date | Yes | End date YYYY-MM-DD | |
| account_id | No | ||
| start_date | Yes | Start date YYYY-MM-DD | |
| campaign_ids | No | Filter by numeric string campaign IDs | |
| time_granularity | No | ALL (default), DAILY, or MONTHLY | |
| campaign_group_ids | No | Filter by campaign group IDs |