AI Studios - Owner/Co-Creator Metrics Dashboard | AISquare Studio

curl -X POST /api/v1/aistudios/metrics/ \
     -H "Content-Type: application/json" \
     -d '{
  "url": "ai-research-studio"
}'

{
  "publication": {
    "id": 123,
    "name": "AI Research Studio",
    "custom_url": "ai-research-studio",
    "created_at": "2025-01-15T10:30:00Z",
    "allow_bookings": true
  },
  "experience_counts": {
    "AI_EXPERT": 15,
    "AI_NOTE": 32,
    "QUEST": 8,
    "PODCAST": 5,
    "total": 60
  },
  "metrics": {
    "total_views": 12450,
    "total_likes": 892,
    "total_bookmarks": 456,
    "total_shares": 123,
    "total_comments": 234,
    "total_appointments": 0,
    "monthly_active_users": 245
  },
  "social_metrics": {
    "followers_count": 1250,
    "following_count": 180
  },
  "generated_at": "2025-09-09T14:30:00Z"
}

OWNER OR CO-CREATOR ACCESS: Metrics dashboard for publication owners and co-creators. Provides detailed analytics including:

Publication basic information (created_at, allow_bookings)
Experience counts by type (AI_EXPERT, AI_NOTE, QUEST, PODCAST)
Engagement metrics (views, likes, bookmarks, shares, comments)
Monthly active users count
Appointments count (placeholder - TODO)
Social metrics (followers and following counts for publication owner)

Access Control: Restricted to publication owners or co-creators only. Caching: Response cached for 1 hour using Django’s cache framework. Performance: Optimized queries with select_related and prefetch_related.

**OWNER OR CO-CREATOR ACCESS:** Metrics dashboard for publication owners and co-creators. Provides detailed analytics including: - Publication basic information (created_at, allow_bookings) - Experience counts by type (AI_EXPERT, AI_NOTE, QUEST, PODCAST) - Engagement metrics (views, likes, bookmarks, shares, comments) - Monthly active users count - Appointments count (placeholder - TODO) - Social metrics (followers and following counts for publication owner) **Access Control:** Restricted to publication owners or co-creators only. **Caching:** Response cached for 1 hour using Django's cache framework. **Performance:** Optimized queries with select_related and prefetch_related.

Request

This endpoint expects an object.

urlstringRequired

Publication custom URL (owner or co-creator access required)

Response

Owner/Co-creator metrics retrieved successfully

publicationobject

experience_countsobject

metricsobject

social_metricsobject

generated_atdatetimeRead-only

Errors

403

Forbidden Error

404

Not Found Error