LinkedIn Ads Read
User wants to see all their LinkedIn campaigns with performance metrics
POST https://api.adspirer.ai/api/v1/tools/list_linkedin_campaigns/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 |
|---|---|---|
account_id | string optional | LinkedIn Ad Account ID (optional - uses default connected account) |
campaign_group_id | string optional | Filter campaigns by Campaign Group ID. Only returns campaigns that belong to this group. Format: numeric ID or urn:li:sponsoredCampaignGroup:XXXXX. |
status_filter | string optional | Filter by status. Default: 'ACTIVE,PAUSED,DRAFT' (excludes deleted/removed clutter). Options: 'ACTIVE', 'PAUSED', 'DRAFT', 'ARCHIVED', 'COMPLETED', 'CANCELED', 'ALL'. Use 'ALL' to include everything including PENDING_DELETION and REMOVED. default: "ACTIVE,PAUSED,DRAFT" |
limit | integer optional | Maximum campaigns to return (default: 50, max: 100) default: 50 |
lookback_days | integer optional | Number of days for metrics (default: 30) default: 30 |
{
"arguments": {
"account_id": "string",
"campaign_group_id": "string",
"status_filter": "ACTIVE,PAUSED,DRAFT",
"limit": 50,
"lookback_days": 30
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for list_linkedin_campaigns)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "list_linkedin_campaigns"
}
{
"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": "list_linkedin_campaigns"
}
{
"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": "list_linkedin_campaigns",
"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