LinkedIn Ads Read
User asks about LinkedIn Ads performance, campaign metrics, B2B engagement, ROAS, or wants to understand how their LinkedIn campaigns are performing
POST https://api.adspirer.ai/api/v1/tools/get_linkedin_campaign_performance/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
start_date | string optional | Start date (YYYY-MM-DD). If provided with end_date, overrides lookback_days for custom date range queries. |
end_date | string optional | End date (YYYY-MM-DD). If provided with start_date, overrides lookback_days for custom date range queries. |
date_range | string optional | Date range preset: 'last_7_days', 'last_14_days', 'last_30_days', 'last_60_days', 'last_90_days'. Overrides lookback_days. Ignored if start_date/end_date are provided. |
raw_data | boolean optional | If true, return ONLY raw metrics as a JSON code block (spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS by campaign/ad/date). Strips severity labels, suggested bids/budgets, industry benchmarks, and optimization recommendations. Use when you run your own attribution model or want to minimize token usage. default: false |
lookback_days | integer optional | Number of days to analyze (7-120). Default: 30. LinkedIn data is available for up to 10 years but 30 days provides the best balance of recency and data volume. default: 30 |
include_campaigns | boolean optional | Include per-campaign breakdown. Default: true default: true |
include_trends | boolean optional | Include trend data (daily metrics, WoW/MoM changes). Default: true default: true |
include_comprehensive | boolean optional | Include creative and engagement analysis. Default: true default: true |
ad_account_id | string optional | LinkedIn Ads account ID (optional - uses default connected account) |
campaign_id | string optional | Filter performance to a specific campaign ID. If not provided, returns account-wide performance. |
campaign_name | string optional | Filter performance by campaign name (partial match). If not provided, returns all campaigns. |
{
"arguments": {
"start_date": "string",
"end_date": "string",
"date_range": "string",
"raw_data": false,
"lookback_days": 30,
"include_campaigns": true
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for get_linkedin_campaign_performance)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "get_linkedin_campaign_performance"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "get_linkedin_campaign_performance"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "get_linkedin_campaign_performance",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: LinkedIn Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai