Get LinkedIn Audience Insights
User asks about B2B audience demographics, which professional segments perform best, targeting optimization, or wants to understand their LinkedIn audience breakdown.
THIS IS LINKEDIN’S KILLER FEATURE - Professional demographic analysis:
Returns B2B audience performance breakdown by:
- Seniority (Entry, Senior, Manager, Director, VP, C-Suite)
- Industry (Technology, Finance, Healthcare, etc.)
- Company Size (1-10, 11-50, 51-200, 201-500, 501-1000, 1000+)
- Job Function (Marketing, Sales, IT, Engineering, HR, etc.)
Each segment includes:
- Impressions, clicks, spend, conversions
- CTR, CPL, ROAS, engagement rate
- Category: SCALE, MAINTAIN, REDUCE, or EXCLUDE
Identifies:
- Best performing segments (to scale)
- Underperforming segments (to reduce/exclude)
- Wasted spend on B2B segments
- Targeting optimization recommendations
Parameters:
- lookback_days: Number of days to analyze (7-120). Default: 30
- start_date: Optional start date (YYYY-MM-DD). Overrides lookback_days when used with end_date.
- end_date: Optional end date (YYYY-MM-DD). Overrides lookback_days when used with start_date. ⚠️ DATE CLARIFICATION: If the user’s date request is vague or ambiguous (e.g., “March to June” without a year, “last quarter”, “recently”, “a few months ago”), ask the user to specify exact dates before calling this tool. Do not assume or guess dates.
- breakdown_types: Optional list of specific breakdowns. Default: all types
- target_roas: Override target ROAS for categorization
- ad_account_id: Required for multi-account users. Get from list_connected_accounts
Example Prompts:
- “Which seniority levels convert best on LinkedIn?”
- “Show me LinkedIn audience breakdown by industry”
- “What company sizes are we reaching on LinkedIn?”
- “Am I reaching decision-makers on LinkedIn?”
- “Which B2B segments should I exclude?”
Execution time: 4-6 seconds
Authorizations
API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.
Headers
Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000
Body
All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.
Input schema for getting LinkedIn B2B audience insights
Response
Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).
Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.