Metrics and analytics

This guide explains the metrics available in AISquare and how to retrieve them using the API.

Overview

AISquare provides endpoints to retrieve engagement and activity metrics for AI Studios (publications).

These metrics are available in two contexts:

• Owner / co-creator metrics
• Public impact metrics

Owner and co-creator metrics

This endpoint provides detailed analytics for users who have access to a publication as:

• Owner
• Co-creator

Endpoint

POST /api/v1/aistudios/metrics/

Request body

1
{
2
  "url": "ai-research-studio"
3
}

Access control

• Requires authentication
• Restricted to publication owners or co-creators
• Returns 403 if access is not allowed

Response includes

Publication details

• id
• name
• custom_url
• created_at
• allow_bookings

Experience counts

Counts of different experience types:

• AI_EXPERT
• AI_NOTE
• QUEST
• PODCAST
• total

Engagement metrics

Aggregated metrics across the publication:

• total_views
• total_likes
• total_bookmarks
• total_shares
• total_comments
• total_appointments

Activity metrics

• monthly_active_users

Social metrics

• followers_count
• following_count

Metadata

• generated_at

Public impact metrics

This endpoint provides public engagement metrics for a publication.

Endpoint

POST /api/v1/aistudios/public-impact/

Request body

1
{
2
  "url": "ai-research-studio"
3
}

Access control

• Requires authentication
• Available to any authenticated user

Response includes

Publication info

• id
• name
• custom_url

Metrics

• total_plays
• likes_count
• completion_rate
• active_users
• saves_count
• influence_score

Metadata

• time_period_days (fixed at 30 days)
• generated_at

Time window

• Public impact metrics are calculated over a fixed 30-day period
• Owner metrics are not explicitly scoped to a fixed window in the spec

Data characteristics

Based on the API:

• Metrics are aggregated at the publication level
• Responses include computed values (e.g. completion_rate, influence_score)
• No per-user breakdown is provided in these endpoints

When to use each endpoint

Error responses

Notes

• Both endpoints require a url field in the request body
• Both endpoints return aggregated metrics for a publication
• Access control differs between endpoints

Related pages

• AI Studios — publication-scoped endpoints
• Working with creators — owner and co-creator profiles
• Permissions and access control — access validation
• Authentication — required for all endpoints
• Core Concepts — metrics in the entity model
• Errors — handle 403, 404 responses