`linkedin_ads_get_insights`

Get LinkedIn Ads Insights

Description

Get LinkedIn Ads analytics with a single pivot dimension. For standard analysis, prefer linkedin_ads_get_performance_report; use this only for MEMBER_* demographic pivots (unique to LinkedIn) or custom metric queries not available in the performance report. MEMBER_* pivots have a 3-event minimum threshold and 12-24 hour data delay, so totals may not match account-level numbers. Max 18 metrics per query.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedin_ads_get_insights",
    "arguments": {
      "account_id": "123456789",
      "pivot": "MEMBER_JOB_FUNCTION",
      "date_preset": "LAST_30_DAYS",
      "reason": "Demographic breakdown by job function"
    }
  }
}

hopkin linkedin insights get

Flag	Type	Required	Description
`--account`	`string`	Required	Ad account ID (numeric, without URN prefix).
`--pivot`	`string`	Required	Analytics pivot dimension. MEMBER_* pivots provide demographic breakdowns unique to LinkedIn.
`--date-preset`	`string`	Optional
`--start-date`	`string`	Optional	ISO date YYYY-MM-DD. Use with end_date to override date_preset.
`--end-date`	`string`	Optional
`--time-granularity`	`string`	Optional
`--campaign-ids`	`array`	Optional	Filter to specific campaigns (numeric IDs).
`--campaign-group-ids`	`array`	Optional	Filter to specific campaign groups (numeric IDs).
`--metrics`	`array`	Optional	LinkedIn adAnalytics metric field names (camelCase, exact names required). Core: impressions, clicks, costInLocalCurrency, costInUsd. Conversions: externalWebsiteConversions, externalWebsitePostClickConversions, externalWebsitePostViewConversions, conversionValueInLocalCurrency. Leads: oneClickLeads, oneClickLeadFormOpens, qualifiedLeads. Video: videoViews, videoCompletions. Engagement: totalEngagements, shares, follows, reactions, comments, landingPageClicks, textUrlClicks, companyPageClicks. Card: cardImpressions, cardClicks, viralCardImpressions, viralCardClicks. Reach: approximateMemberReach (only with ACCOUNT/CAMPAIGN_GROUP/CAMPAIGN pivot, ≤92 day range). IMPORTANT: Do NOT use aliases like "conversions", "leads", "spend", or "reach" — use the exact camelCase field names listed above. Max 18 (pivotValues + dateRange count toward the 20-field API limit). Defaults to: impressions, clicks, costInLocalCurrency, costInUsd, externalWebsiteConversions, oneClickLeads, videoViews, totalEngagements.
`--include-conversion-breakdown`	`boolean`	Optional	When true (and pivot is not CONVERSION), runs a second query to break down conversions per action with names.

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

Job function breakdown
Seniority breakdown
Industry breakdown
Device type breakdown

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	Ad account ID (numeric, without URN prefix).minLength: 1
`pivot`	`string`	Required	Analytics pivot dimension. MEMBER_* pivots provide demographic breakdowns unique to LinkedIn. `ACCOUNT` `CAMPAIGN_GROUP` `CAMPAIGN` `CREATIVE` `SHARE` `COMPANY` `CONVERSION` `CONVERSATION_NODE` `SERVING_LOCATION` `PLACEMENT_NAME` `IMPRESSION_DEVICE_TYPE` `CARD_INDEX` `MEMBER_COMPANY_SIZE` `MEMBER_INDUSTRY` `MEMBER_SENIORITY` `MEMBER_JOB_TITLE` `MEMBER_JOB_FUNCTION` `MEMBER_COUNTRY_V2` `MEMBER_REGION_V2` `MEMBER_COUNTY` `MEMBER_COMPANY`
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (8)

Name	Type	Required	Description
`date_preset`	`string`	Optional	`LAST_7_DAYS` `LAST_14_DAYS` `LAST_30_DAYS` `THIS_MONTH` `LAST_MONTH` `LAST_90_DAYS`
`start_date`	`string`	Optional	ISO date YYYY-MM-DD. Use with end_date to override date_preset.
`end_date`	`string`	Optional
`time_granularity`	`string`	Optional	`ALL` `DAILY` `MONTHLY`
`campaign_ids`	`array`	Optional	Filter to specific campaigns (numeric IDs).
`campaign_group_ids`	`array`	Optional	Filter to specific campaign groups (numeric IDs).
`metrics`	`array`	Optional	LinkedIn adAnalytics metric field names (camelCase, exact names required). Core: impressions, clicks, costInLocalCurrency, costInUsd. Conversions: externalWebsiteConversions, externalWebsitePostClickConversions, externalWebsitePostViewConversions, conversionValueInLocalCurrency. Leads: oneClickLeads, oneClickLeadFormOpens, qualifiedLeads. Video: videoViews, videoCompletions. Engagement: totalEngagements, shares, follows, reactions, comments, landingPageClicks, textUrlClicks, companyPageClicks. Card: cardImpressions, cardClicks, viralCardImpressions, viralCardClicks. Reach: approximateMemberReach (only with ACCOUNT/CAMPAIGN_GROUP/CAMPAIGN pivot, ≤92 day range). IMPORTANT: Do NOT use aliases like "conversions", "leads", "spend", or "reach" — use the exact camelCase field names listed above. Max 18 (pivotValues + dateRange count toward the 20-field API limit). Defaults to: impressions, clicks, costInLocalCurrency, costInUsd, externalWebsiteConversions, oneClickLeads, videoViews, totalEngagements.
`include_conversion_breakdown`	`boolean`	Optional	When true (and pivot is not CONVERSION), runs a second query to break down conversions per action with names.

Examples

Job function breakdown

{
  "account_id": "123456789",
  "pivot": "MEMBER_JOB_FUNCTION",
  "date_preset": "LAST_30_DAYS",
  "reason": "Demographic breakdown by job function"
}

hopkin linkedin insights get --account 123456789 --pivot MEMBER_JOB_FUNCTION --date-preset LAST_30_DAYS

Seniority breakdown

{
  "account_id": "123456789",
  "pivot": "MEMBER_SENIORITY",
  "date_preset": "LAST_30_DAYS",
  "reason": "Performance by member seniority level"
}

hopkin linkedin insights get --account 123456789 --pivot MEMBER_SENIORITY --date-preset LAST_30_DAYS

Industry breakdown

{
  "account_id": "123456789",
  "pivot": "MEMBER_INDUSTRY",
  "date_preset": "LAST_30_DAYS",
  "reason": "Reach and engagement by industry"
}

hopkin linkedin insights get --account 123456789 --pivot MEMBER_INDUSTRY --date-preset LAST_30_DAYS

Device type breakdown

{
  "account_id": "123456789",
  "pivot": "IMPRESSION_DEVICE_TYPE",
  "date_preset": "LAST_30_DAYS",
  "reason": "Performance split by device type"
}

hopkin linkedin insights get --account 123456789 --pivot IMPRESSION_DEVICE_TYPE --date-preset LAST_30_DAYS