`linkedin_ads_get_performance_report`

Get LinkedIn Ads Performance Report

Description

Get a full-funnel performance report with up to 3 pivot dimensions and optional per-conversion-action breakdown. MEMBER_* demographic pivots are not supported here — use linkedin_ads_get_insights instead.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedin_ads_get_performance_report",
    "arguments": {
      "account_id": "123456789",
      "pivots": [
        "CAMPAIGN"
      ],
      "date_preset": "LAST_30_DAYS",
      "reason": "User wants full campaign performance report"
    }
  }
}

hopkin linkedin performance-report get

Flag	Type	Required	Description
`--account`	`string`	Required	Ad account ID (numeric, without URN prefix).
`--pivots`	`array`	Optional	Up to 3 pivot dimensions. OBJECTIVE_TYPE is only available in q=statistics.
`--date-preset`	`string`	Optional
`--start-date`	`string`	Optional
`--end-date`	`string`	Optional
`--time-granularity`	`string`	Optional
`--campaign-ids`	`array`	Optional
`--campaign-group-ids`	`array`	Optional
`--include-conversion-breakdown`	`boolean`	Optional	Run a second query for per-conversion-action breakdown. Adds one extra API call.

{
  "mcpServers": {
    "linkedin-ads": {
      "url": "https://linkedin.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Ad account ID (numeric, without URN prefix).minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`pivots`	`array`	Optional	Up to 3 pivot dimensions. OBJECTIVE_TYPE is only available in q=statistics.
`date_preset`	`string`	Optional	`LAST_7_DAYS` `LAST_14_DAYS` `LAST_30_DAYS` `THIS_MONTH` `LAST_MONTH` `LAST_90_DAYS`
`start_date`	`string`	Optional
`end_date`	`string`	Optional
`time_granularity`	`string`	Optional	`ALL` `DAILY` `MONTHLY`
`campaign_ids`	`array`	Optional
`campaign_group_ids`	`array`	Optional
`include_conversion_breakdown`	`boolean`	Optional	Run a second query for per-conversion-action breakdown. Adds one extra API call.

Examples

Campaign report

{
  "account_id": "123456789",
  "pivots": [
    "CAMPAIGN"
  ],
  "date_preset": "LAST_30_DAYS",
  "reason": "User wants full campaign performance report"
}

hopkin linkedin performance-report get --account 123456789 --pivots CAMPAIGN --date-preset LAST_30_DAYS

With conversion breakdown

{
  "account_id": "123456789",
  "pivots": [
    "CAMPAIGN"
  ],
  "date_preset": "LAST_30_DAYS",
  "include_conversion_breakdown": true,
  "reason": "Show conversion breakdown by campaign"
}

hopkin linkedin performance-report get --account 123456789 --pivots CAMPAIGN --date-preset LAST_30_DAYS --include-conversion-breakdown true

Daily campaign group

{
  "account_id": "123456789",
  "pivots": [
    "CAMPAIGN_GROUP"
  ],
  "time_granularity": "DAILY",
  "date_preset": "LAST_7_DAYS",
  "reason": "Daily trend by campaign group"
}

hopkin linkedin performance-report get --account 123456789 --pivots CAMPAIGN_GROUP --time-granularity DAILY --date-preset LAST_7_DAYS