Analytics tools provide real-time data about social trends, competitor activity, and creator insights to inform content strategy.

Viral Trends

Discover trending topics across social platforms.

Tool: aidelly_list_viral_trends

Input:

{
  "workspace_id": "ws_uuid",
  "platforms": ["twitter", "linkedin"],
  "time_window": "last_24_hours",
  "limit": 10
}

Output:

{
  "data": {
    "trends": [
      {
        "trend_id": "trend_uuid",
        "topic": "AI Safety",
        "platforms": ["twitter", "linkedin"],
        "current_momentum": 8.7,
        "mention_count": 125000,
        "growth_rate": 0.45,
        "sentiment": "positive",
        "top_hashtags": ["#AISafety", "#Ethics", "#AI"],
        "time_window": "last_24_hours",
        "discovered_at": "2026-02-18T08:30:00Z",
        "peak_at": "2026-02-18T15:00:00Z",
        "estimated_duration": "48 hours"
      },
      {
        "trend_id": "trend_uuid_2",
        "topic": "Remote Work Trends",
        "platforms": ["linkedin"],
        "current_momentum": 7.2,
        "mention_count": 87000,
        "growth_rate": 0.23,
        "sentiment": "neutral",
        "top_hashtags": ["#RemoteWork", "#WorkCulture"],
        "estimated_duration": "72 hours"
      }
    ],
    "count": 2,
    "last_updated": "2026-02-18T20:00:00Z"
  }
}

Parameters:

platforms (optional) — filter by platform: twitter, linkedin, facebook, instagram
time_window (optional) — last_24_hours, last_7_days, last_30_days (default: last_24_hours)
limit (default: 10, max: 50)

Use for:

Real-time content inspiration
Timing posts around trending topics
Monitoring industry conversations
Competitive content strategy

Competitors

Track competitor profiles and their recent activity.

Add Competitor

Tool: aidelly_add_competitor

Input:

{
  "workspace_id": "ws_uuid",
  "brand_id": "br_uuid",
  "idempotency_key": "add-competitor-001",
  "competitor_name": "TechCorp Inc",
  "platforms": [
    {
      "platform": "twitter",
      "handle": "techcorp"
    },
    {
      "platform": "linkedin",
      "profile_url": "https://linkedin.com/company/techcorp"
    }
  ]
}

Output:

{
  "data": {
    "competitor_id": "competitor_uuid",
    "name": "TechCorp Inc",
    "platforms": [
      {
        "platform": "twitter",
        "handle": "techcorp",
        "followers": 125000,
        "avg_engagement_rate": 0.045,
        "posting_frequency": "3-4 posts/day"
      },
      {
        "platform": "linkedin",
        "followers": 45000,
        "avg_engagement_rate": 0.032,
        "posting_frequency": "1-2 posts/day"
      }
    ],
    "added_at": "2026-02-18T10:30:00Z"
  }
}

List Competitors

Tool: aidelly_list_competitors

Input:

{
  "workspace_id": "ws_uuid",
  "brand_id": "br_uuid",
  "limit": 10,
  "page": 1
}

Output:

{
  "data": {
    "competitors": [
      {
        "competitor_id": "competitor_uuid",
        "name": "TechCorp Inc",
        "tracked_platforms": ["twitter", "linkedin"],
        "avg_engagement_rate": 0.041,
        "last_post": "2026-02-18T19:30:00Z",
        "posting_frequency": "3-4 posts/day",
        "recent_posts": [
          {
            "post_id": "post_uuid",
            "platform": "twitter",
            "content_preview": "Excited to announce...",
            "engagement": 1250,
            "published_at": "2026-02-18T19:30:00Z"
          }
        ]
      }
    ],
    "pagination": { "page": 1, "limit": 10, "total": 12 }
  }
}

Use for:

Benchmarking your performance
Understanding competitor content strategy
Finding content gaps
Timing your posts around competitor activity

Creators

Track creator profiles and content trends.

Add Creator

Tool: aidelly_add_creator

Input:

{
  "workspace_id": "ws_uuid",
  "brand_id": "br_uuid",
  "idempotency_key": "add-creator-001",
  "creator_name": "Sarah Chen",
  "platforms": [
    {
      "platform": "twitter",
      "handle": "sarah_chen"
    },
    {
      "platform": "linkedin",
      "profile_url": "https://linkedin.com/in/sarahchen"
    }
  ]
}

Output:

{
  "data": {
    "creator_id": "creator_uuid",
    "name": "Sarah Chen",
    "bio": "Tech writer, product strategist, startup advisor",
    "platforms": [
      {
        "platform": "twitter",
        "handle": "sarah_chen",
        "followers": 87000,
        "engagement_rate": 0.062,
        "content_type": "product strategy, tech trends"
      },
      {
        "platform": "linkedin",
        "profile_url": "https://linkedin.com/in/sarahchen",
        "followers": 42000,
        "engagement_rate": 0.048,
        "content_type": "career advice, leadership"
      }
    ],
    "added_at": "2026-02-18T10:30:00Z"
  }
}

List Creators

Tool: aidelly_list_creators

Input:

{
  "workspace_id": "ws_uuid",
  "brand_id": "br_uuid",
  "limit": 10,
  "page": 1
}

Output:

{
  "data": {
    "creators": [
      {
        "creator_id": "creator_uuid",
        "name": "Sarah Chen",
        "tracked_platforms": ["twitter", "linkedin"],
        "avg_engagement_rate": 0.055,
        "total_followers": 129000,
        "recent_posts": [
          {
            "post_id": "post_uuid",
            "platform": "twitter",
            "content_text": "Just finished reading...",
            "engagement": 2340,
            "published_at": "2026-02-18T14:30:00Z"
          }
        ],
        "content_themes": ["product strategy", "tech trends", "leadership"],
        "posting_frequency": "2-3 posts/day"
      }
    ],
    "pagination": { "page": 1, "limit": 10, "total": 8 }
  }
}

Use for:

Identifying industry influencers
Studying high-engagement creators
Collaboration opportunities
Content inspiration by topic

Analytics Insights

Access AI-generated insights about your performance.

Tool: aidelly_get_analytics_insights

Input:

{
  "workspace_id": "ws_uuid",
  "brand_id": "br_uuid",
  "limit": 5,
  "type": "performance",
  "platforms": ["linkedin", "twitter"]
}

Output:

{
  "data": {
    "insights": [
      {
        "id": "insight_uuid",
        "insight_type": "performance",
        "title": "LinkedIn outperforming by 2.5x",
        "description": "Your recent posts on LinkedIn have 2.5x higher engagement rates compared to Twitter.",
        "impact": "high",
        "confidence": 0.94,
        "actionable": true,
        "suggested_actions": [
          "Increase LinkedIn posting frequency to 3x per week",
          "Adapt Twitter content to be more conversational and timely",
          "Test LinkedIn article format for deeper engagement"
        ],
        "related_metrics": {
          "linkedin_engagement_rate": 0.068,
          "twitter_engagement_rate": 0.027,
          "sample_size": 120
        },
        "platforms": ["linkedin", "twitter"],
        "created_at": "2026-02-18T10:30:00Z",
        "dismissed": false
      },
      {
        "id": "insight_uuid_2",
        "insight_type": "timing",
        "title": "Best posting time: Tuesday 10 AM",
        "description": "Posts published on Tuesday between 10-11 AM see 38% higher engagement.",
        "impact": "medium",
        "confidence": 0.87,
        "actionable": true,
        "suggested_actions": [
          "Schedule important posts for Tuesday mornings",
          "Use this window for product announcements",
          "Test consistency over next 30 days"
        ],
        "related_metrics": {
          "peak_engagement_rate": 0.072,
          "baseline_engagement_rate": 0.052,
          "observed_days": 14
        },
        "platforms": ["linkedin"],
        "created_at": "2026-02-17T15:00:00Z",
        "dismissed": false
      }
    ]
  }
}

Insight Types:

performance — platform/content comparison
timing — optimal posting times
content — topic and format recommendations
growth — follower growth patterns
audience — audience engagement and demographics

Use for:

Strategic content decisions
Optimization recommendations
Performance benchmarking
Identifying trends in your data

Preview Tools

The following tools are currently in preview and may change:

🚧 Competitors Advanced Analytics — detailed post-level competitor metrics (coming soon)
🚧 Audience Demographics — detailed audience breakdown by geography, industry, etc. (coming soon)
🚧 Content Calendar Optimization — AI recommendations for ideal posting calendar (coming soon)

Example: Content Strategy Research

# Step 1: Discover trending topics
trends=$(aidelly_list_viral_trends --workspace_id ws_abc \
  --platforms linkedin,twitter --time_window last_24_hours)

# Step 2: Check competitor activity
competitors=$(aidelly_list_competitors --workspace_id ws_abc)

# Step 3: Study high-performing creators
creators=$(aidelly_list_creators --workspace_id ws_abc)

# Step 4: Get AI insights
insights=$(aidelly_get_analytics_insights --workspace_id ws_abc \
  --type performance,timing)

# Step 5: Use trends + insights to inform content strategy
for insight in insights.insights:
  if insight.actionable:
    # Plan posts using trending topics and optimal timing
    plan_post(
      topic: trends[0].topic,
      platform: insight.platforms[0],
      scheduled_at: "Tuesday 10:00 AM"
    )

Rate Limits

Analytics and insights tools count toward your plan's read rate limit. See Rate Limits for details.

Competitor and creator tracking is subject to data freshness limits:

Competitor activity: updated every 2 hours
Creator data: updated every 4 hours
Trends: updated hourly (real-time)

Analytics and Insights Tools

Viral Trends

Competitors

Add Competitor

List Competitors

Creators

Add Creator

List Creators

Analytics Insights

Preview Tools

Example: Content Strategy Research

Rate Limits

See Also