# Bolta.get Audience Insights

> Retrieve audience demographics, behavior patterns, and engagement trends for data-driven content strategy

- Skill: `boltaai/bolta-get-audience-insights` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add boltaai/bolta-get-audience-insights`
- Raw SKILL.md: https://api.skillmd.com/api/skills/boltaai/bolta-get-audience-insights/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: boltaai (https://skillmd.com/u/boltaai)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/boltaai/bolta-get-audience-insights

---


## Goal
Retrieve audience demographics, behavior patterns, and engagement trends to help agents understand WHO they're creating content for and HOW that audience behaves.

## Which Agents Use This
- **analytics** — Primary use case for audience analysis and reporting
- **content_creator** — Check audience preferences before drafting content
- **custom** — Any agent needing audience context for decision-making

## Hard Rules
1. MUST aggregate over time period (not single snapshot)
2. MUST identify actionable patterns (not just raw counts)
3. SHOULD compare to platform benchmarks when available
4. Require valid account_id that belongs to workspace

## Steps

### 1. Validate input
- Verify account_id exists and belongs to workspace
- Validate time_period is supported

### 2. Query platform APIs
- Fetch follower demographics from platform (LinkedIn, Twitter, etc.)
- Fetch engagement behavior data
- Fetch content performance by type

### 3. Aggregate and analyze
- Calculate growth rates
- Identify peak activity times
- Determine content format preferences
- Extract actionable patterns

### 4. Return structured insights
- Demographics: follower count, growth rate, locations, industries
- Behavior: peak activity times, session duration, engagement by day
- Content preferences: top formats, topics, optimal post length

## Output
```json
{
  "success": true,
  "account_id": "uuid",
  "time_period": "30d",
  "insights": {
    "demographics": {
      "follower_count": 12450,
      "growth_rate_30d": 0.08,
      "top_locations": ["United States", "United Kingdom", "Canada"],
      "top_industries": ["Technology", "Marketing", "SaaS"]
    },
    "behavior": {
      "peak_activity_times": ["9am-11am EST", "2pm-4pm EST"],
      "engagement_by_day": {
        "thursday": 0.038,
        "sunday": 0.012
      }
    },
    "content_preferences": {
      "top_formats": ["thread", "single_post", "carousel"],
      "top_topics": ["remote work", "productivity", "team collaboration"],
      "avg_engagement_by_length": {
        "short": 0.021,
        "medium": 0.028,
        "long": 0.034
      }
    }
  }
}
```

## Failure Handling
- If account_id not found: return error "Account not found"
- If platform API fails: return cached data with warning
- If insufficient data for time_period: suggest longer period

## Example Usage

### Scenario: Analytics agent analyzing audience
```json
{
  "account_id": "uuid",
  "insights_type": "demographics",
  "time_period": "30d"
}
```
**Result:** Receive demographic breakdown for strategy planning