LinkedIn Ads Read
User needs ad copy for LinkedIn campaigns
POST https://api.adspirer.ai/api/v1/tools/generate_linkedin_ad_creatives/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 |
|---|---|---|
business_name | string required | Name of the business/product being advertised |
business_description | string required | Brief description of what the business does (1-2 sentences) |
target_audience | string required | Description of who the ad is targeting (e.g., 'Marketing managers at SaaS companies') |
value_proposition | string required | Main benefit or value the product/service provides |
landing_page_url | string required | URL where users will be directed when they click the ad |
campaign_objective | string optional | Campaign objective: WEBSITE_VISIT, LEAD_GENERATION, BRAND_AWARENESS, etc. default: "WEBSITE_VISIT" |
tone | string optional | Tone of voice: 'professional', 'casual', 'urgent', 'inspirational' default: "professional" |
include_stats | boolean optional | Whether to include statistics/numbers in copy (user should provide if True) default: false |
stats_to_include | string optional | Statistics to potentially include (e.g., '500+ customers', '10 hours saved/week') |
{
"arguments": {
"business_name": "string",
"business_description": "string",
"target_audience": "string",
"value_proposition": "string",
"landing_page_url": "https://example.com",
"campaign_objective": "WEBSITE_VISIT",
"tone": "professional",
"include_stats": false,
"stats_to_include": "string"
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for generate_linkedin_ad_creatives)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "generate_linkedin_ad_creatives"
}
{
"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": "generate_linkedin_ad_creatives"
}
{
"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": "generate_linkedin_ad_creatives",
"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