Analyze LinkedIn Creative Performance

User asks about ad/creative performance, wants to identify winning/losing ad variations, or asks about creative fatigue.

Analyzes LinkedIn creative/ad performance:

Returns:

Top performing creatives by engagement rate
Underperforming creatives needing attention
Creative fatigue indicators (running too long)
Video performance (views, completion rates)
Engagement breakdown per creative
Recommendations for creative refresh

Creative Metrics:

Impressions, clicks, CTR
Engagement rate (likes, comments, shares)
Lead generation (forms, completions)
Video metrics (views, quartile completions)
Days running (for fatigue detection)

Parameters:

lookback_days: Number of days to analyze (7-120). 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.
campaign_id: Optional filter to specific campaign
ad_account_id: Required for multi-account users. Get from list_connected_accounts

Example Prompts:

“Which LinkedIn ads are performing best?”
“Show me creative performance on LinkedIn”
“Are any LinkedIn creatives fatigued?”
“Which ads should I refresh on LinkedIn?”

Execution time: 2-3 seconds

POST

api

tools

analyze_linkedin_creative_performance

execute

Analyze LinkedIn Creative Performance

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/analyze_linkedin_creative_performance/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_id": "string",
    "date_range": "string",
    "end_date": "string",
    "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 analyze_linkedin_creative_performance)"
  },
  "success": true,
  "tool": "analyze_linkedin_creative_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 analyzing LinkedIn creative/ad performance

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

Analyze LinkedIn Wasted SpendUser asks about wasted ad spend, unprofitable campaigns, where their LinkedIn budget is being wasted, or wants to identify underperformers. Identifies LinkedIn campaigns and B2B segments wasting money: Campaign Analysis: - Campaigns losing money (ROAS `<` 1.0 = actual loss) - Campaigns underperforming (ROAS below target = opportunity cost) - Severity classification (CRITICAL, HIGH, MEDIUM) - Wasted spend calculation per campaign B2B Demographic Waste: - Seniority levels with poor ROAS - Industries not converting - Company sizes wasting budget - Job functions underperforming Creative Waste: - Fatigued creatives (14-day threshold) - Low engagement creatives - High spend but low lead creatives Returns: - Total wasted spend and percentage - Campaigns to pause/reduce - Segments to exclude - Quick actions with monthly savings estimates Parameters: - lookback_days: Number of days to analyze (7-120). 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. - target_roas: Override target ROAS threshold - include_demographic_breakdown: Include B2B segment waste. Default: true - include_creative_analysis: Include creative-level waste. Default: true - ad_account_id: Required for multi-account users. Get from list_connected_accounts Example Prompts: - "Where am I wasting money on LinkedIn?" - "Which LinkedIn campaigns are losing money?" - "Show me LinkedIn wasted spend" - "Which B2B segments should I stop targeting?" - "How can I reduce LinkedIn ad waste?" Execution time: 4-6 seconds **Quick Actions (IMPORTANT — read severity context first):** - ⏳ LEARNING campaigns → Do NOT pause. Monitor for 14+ days before judging. - ❓ INSUFFICIENT_DATA campaigns → Need more spend before analysis is meaningful. - 🚨 CRITICAL campaigns (established, 14+ days, ZERO conversions) → Consider pausing - 🚨 CRITICAL campaigns (established, 14+ days, HAS conversions) → Review performance, verify revenue in ad platform before reducing budget - 🔴 HIGH severity (established, 14+ days) → Consider reducing budget by 50-70% - 🟡 MEDIUM → Optimize targeting, ad copy, landing pages ⚠️ **NEVER say "pause" for a campaign that has conversions.** Say "review" or "reduce budget" instead. ⚠️ **NEVER recommend pausing a campaign in LEARNING phase.** ⚠️ **If ALL campaigns are LEARNING or INSUFFICIENT_DATA, tell the user their account is too new for waste analysis and recommend checking back in 2 weeks.** ⚠️ **Consider campaign objective: brand awareness campaigns will not have ROAS data. This is normal.** ⚠️ **When data confidence is MEDIUM or LOW, soften all recommendations and add verification prompts.**

Analyze LinkedIn Creative Performance

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/analyze_linkedin_creative_performance/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "campaign_id": "string",
    "date_range": "string",
    "end_date": "string",
    "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 analyze_linkedin_creative_performance)"
  },
  "success": true,
  "tool": "analyze_linkedin_creative_performance"
}