explain_linkedin_objectives

LinkedIn Ads Read

User asks about LinkedIn campaign objectives or which one to choose

Endpoint

POST https://api.adspirer.ai/api/v1/tools/explain_linkedin_objectives/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

User asks about LinkedIn campaign objectives or which one to choose.

Explain all LinkedIn campaign objectives and recommend the best one.

What this tool does:
- Explains all 8 LinkedIn objectives in detail
- Shows typical costs and expected results
- Provides personalized recommendation based on user's goal
- Helps user decide which objective to use

Parameters:
- business_type: Type of business (optional)
- goal: What user wants to achieve (optional)

Example Prompts:
- "What objectives can I choose for LinkedIn?"
- "Which objective should I use for my SaaS?"
- "Explain LinkedIn campaign objectives"
- "I want to get signups, which objective?"

Execution time: <1 second

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`business_type`	`string` optional	Type of business (e.g., 'B2B SaaS', 'E-commerce', 'Agency')
`goal`	`string` optional	What the user wants to achieve (e.g., 'get signups', 'drive traffic', 'build awareness')

Example request

{
  "arguments": {
    "business_type": "string",
    "goal": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for explain_linkedin_objectives)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "explain_linkedin_objectives"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "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_objectives"
}

402 — Quota exhausted

{
  "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_objectives",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

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