LinkedIn Ads Read
User asks why their LinkedIn metrics changed, wants to understand a performance drop/spike, or says something like "My LinkedIn leads dropped 40%, why?" Explains significant metric changes with contr
POST https://api.adspirer.ai/api/v1/tools/explain_linkedin_anomaly/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 |
|---|---|---|
metric | string optional | Metric to analyze. Options: roas, ctr, cpc, cpm, conversions, conversion_rate, leads, engagement_rate, lead_form_completion_rate. Default: 'ctr' default: "ctr" |
period_start | string optional | Start date of analysis period (YYYY-MM-DD format). Defaults to 7 days ago. |
period_end | string optional | End date of analysis period (YYYY-MM-DD format). Defaults to yesterday. |
comparison_period_start | string optional | Optional start date of comparison period. Defaults to same-length period immediately before analysis period. |
comparison_period_end | string optional | Optional end date of comparison period. Defaults to day before period_start. |
ad_account_id | string optional | LinkedIn Ad Account ID. Required for multi-account users. Get from list_connected_accounts. |
raw_data | boolean optional | If true, return ONLY raw metrics as a JSON code block (no severity labels, suggested bids/budgets, industry benchmarks, or optimization recommendations). Use when you run your own attribution model or want to minimize token usage. default: false |
{
"arguments": {
"metric": "ctr",
"period_start": "string",
"period_end": "string",
"comparison_period_start": "string",
"comparison_period_end": "string",
"ad_account_id": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for explain_linkedin_anomaly)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "explain_linkedin_anomaly"
}
{
"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": "explain_linkedin_anomaly"
}
{
"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": "explain_linkedin_anomaly",
"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