Get LinkedIn Campaign Performance

User asks about LinkedIn Ads performance, campaign metrics, B2B engagement, ROAS, or wants to understand how their LinkedIn campaigns are performing.

Returns comprehensive LinkedIn Ads performance metrics including:

Account summary (total spend, impressions, clicks, CTR, conversions, ROAS)
LinkedIn-specific metrics (engagements, leads, cost per lead)
Campaign breakdown with performance categorization
Trend data (daily metrics, week-over-week, month-over-month changes)
Actionable recommendations

Parameters:

lookback_days: Number of days to analyze (7, 14, 30, 60, 90). Default: 30
start_date: Optional start date (YYYY-MM-DD). Overrides lookback_days when used with end_date.
end_date: Optional end date (YYYY-MM-DD). Overrides lookback_days when used with start_date. ⚠️ DATE CLARIFICATION: If the user’s date request is vague or ambiguous (e.g., “March to June” without a year, “last quarter”, “recently”, “a few months ago”), ask the user to specify exact dates before calling this tool. Do not assume or guess dates.
include_campaigns: Include per-campaign breakdown. Default: true
include_trends: Include trend analysis. Default: true
include_comprehensive: Include creative/engagement analysis. Default: true
ad_account_id: Required for multi-account users. Get from list_connected_accounts

Example Prompts:

“How are my LinkedIn ads performing?”
“Show me LinkedIn campaign performance for the last 30 days”
“What’s my LinkedIn ROAS this month?”
“Which LinkedIn campaigns are performing best?”

Execution time: 3-5 seconds

POST

/

api

/

v1

/

tools

/

get_linkedin_campaign_performance

/

execute

Get LinkedIn Campaign Performance

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/get_linkedin_campaign_performance/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "date_range": "string",
    "end_date": "string",
    "include_campaigns": true,
    "lookback_days": 30,
    "raw_data": false,
    "start_date": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for get_linkedin_campaign_performance)"
  },
  "success": true,
  "tool": "get_linkedin_campaign_performance"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for getting LinkedIn campaign performance metrics

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Get LinkedIn Campaign StructureUser wants full details about a specific LinkedIn campaign. Get complete campaign structure including creatives, targeting, and configuration. Returns: - Campaign details (name, status, objective, budget, schedule) - All creatives/ads linked to campaign - Full targeting criteria with resolved names - Conversion tracking setup - Campaign Manager link Parameters: - campaign_id: Campaign ID to fetch (required) - account_id: Optional LinkedIn Ad Account ID Example Prompts: - "Show me details for campaign 123456" - "What's the targeting for my LinkedIn campaign?" - "How many ads are in my campaign?" Execution time: 3-5 seconds

Get LinkedIn Campaign Performance

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/get_linkedin_campaign_performance/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "date_range": "string",
    "end_date": "string",
    "include_campaigns": true,
    "lookback_days": 30,
    "raw_data": false,
    "start_date": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for get_linkedin_campaign_performance)"
  },
  "success": true,
  "tool": "get_linkedin_campaign_performance"
}