ibl-data-manager (3.59.0-ai-plus)
API for iblai
Request
Retrieve user sentiment distribution.
This endpoint returns data on the distribution of user sentiments (positive, negative, neutral) within a specified date range, expressed as percentages.
Args: request: The HTTP request containing filter query parameters. org: Organization key identifier.
Returns: Response: Sentiment distribution percentages and total sentiment count.
Raises: NotFound: If the specified organization does not exist. BadRequest: If the provided parameters are invalid.
Query Parameters: start_date (str): Start date for filtering (YYYY-MM-DD) - required. end_date (str): End date for filtering (YYYY-MM-DD) - required.
- Mock server
https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/user-sentiment/
https://base.manager.iblai.app/api/ai-analytics/orgs/{org}/users/{user_id}/user-sentiment/
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/orgs/{org}/users/{user_id}/user-sentiment/?end_date=string&group_by=day&start_date=string' \
-H 'Authorization: YOUR_API_KEY_HERE'{ "sentiment_distribution": { "positive": 65.25, "negative": 12.5, "neutral": 22.25 }, "total_sentiments": 400 }
Request
Get active user counts over time.
This endpoint provides daily counts of active users (users with known activity) over a specified time period.
Query Parameters: start_date (str, optional): Start date for the time range (ISO format) end_date (str, optional): End date for the time range (ISO format)
Returns: Daily active user counts over the specified time period, with change metrics compared to previous periods.
Default time range is the last 7 days if no dates are specified.
An active user is defined as a user with any activity within the past 30 days.
- Mock server
https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/overview/orgs/{org}/active-users
https://base.manager.iblai.app/api/ai-analytics/overview/orgs/{org}/active-users
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/overview/orgs/{org}/active-users?department_id=0&end_date=string&format=json&include_main_platform=true&start_date=string' \
-H 'Authorization: YOUR_API_KEY_HERE'{ "data": { "property1": null, "property2": null }, "total": 0, "meta": { "total": 0, "change_range": 0, "change_last_seven_days": 0, "change_last_thirty_days": 0, "change_last_seven_days_percent": 0, "change_last_thirty_days_percent": 0, "change_range_percent": 0.1 } }
Request
Get average grade value for platform, course, or user.
This endpoint returns the average grade at different levels:
- Platform level: Average grade across all courses
- Course level: Average grade for a specific course
- Learner level: Average grade for a specific learner
- Course-learner level: Grade for a specific learner in a specific course
Query Parameters: course_id (str, optional): Filter by course ID learner_id (str, optional): Filter by username or email
Returns: The average grade value based on the specified filters.
Access Control:
- Platform admins can access any grade data
- Learners can access their own grade data
- Mock server
https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/overview/orgs/{org}/average-grade
https://base.manager.iblai.app/api/ai-analytics/overview/orgs/{org}/average-grade
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://docs.ibl.ai/_mock/apis/ibl/api/ai-analytics/overview/orgs/{org}/average-grade?department_id=0&format=json&include_main_platform=true' \
-H 'Authorization: YOUR_API_KEY_HERE'{ "data": { "average": 0.1 } }