Skip to content
API Reference/
/
analytics_time_retrieve

ibl-data-manager (4.84.1-ai-plus)

API for iblai

Download OpenAPI description
ibl.json
ibl.yaml
Languages
Servers
Mock server
https://docs.ibl.ai/_mock/apis/ibl/
https://base.manager.iblai.app/

ai-account

Operations

ai-analytics

Operations

analytics_sessions_details_retrieve

Request

Security
PlatformApiKeyAuthentication
Query
date_filterstringnon-empty
  • today - Today only
  • 7d - Last 7 days
  • 30d - Last 30 days
  • 90d - Last 90 days
  • all_time - All time
  • custom - Custom date range
Default "today"
Enum"today""7d""30d""90d""all_time""custom"
end_datestring(date)
limitinteger[ 1 .. 100 ]
Default 20
mentor_unique_idstring(uuid)
pageinteger>= 1
Default 1
platform_keystringnon-empty
searchstring

Search by topic name

start_datestring(date)
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/analytics/sessions/details/?date_filter=today&end_date=2019-08-24&limit=20&mentor_unique_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&page=1&platform_key=string&search=string&start_date=2019-08-24' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Bodyapplication/json
resultsArray of objects(TopicDetail)required
results[].​namestringrequired
results[].​messagesintegerrequired
results[].​conversationsintegerrequired
results[].​sessionsintegerrequired
results[].​average_ratingstring
results[].​rating_countinteger
paginationobjectrequired
pagination.​property name*anyadditional property
Response
application/json
{
  "results": [
    { … }
  ],
  "pagination": {
    "property1": null,
    "property2": null
  }
}

analytics_time_retrieve

Request

Time Analytics API - User activity patterns by time of day and day of week.

Provides heatmap data showing when users are most active, useful for:

  • Understanding peak usage times
  • Capacity planning and resource allocation
  • User behavior analysis
  • Support scheduling optimization

Key Features:

  • Day of week patterns (0=Sunday through 6=Saturday)
  • Hour of day activity levels (0-23)
  • Flexible date range filtering
  • Platform and mentor-specific filtering
  • Message count aggregation

Data Structure:

  • day_of_week: 0-6 (Sunday-Saturday)
  • hour: 0-23 (24-hour format)
  • value: Message count for that time slot
Security
PlatformApiKeyAuthentication
Query
date_filterstringnon-empty
  • today - Today only
  • 7d - Last 7 days
  • 30d - Last 30 days
  • 90d - Last 90 days
  • all_time - All time
  • custom - Custom date range
Default "today"
Enum"today""7d""30d""90d""all_time""custom"
end_datestring(date)
granularitystringnon-empty
  • day - day
  • hour - hour
  • week - week
  • month - month
Default "hour"
Enum"day""hour""week""month"
mentor_unique_idstring(uuid)
platform_keystringnon-empty
start_datestring(date)
curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/analytics/time/?date_filter=today&end_date=2019-08-24&granularity=day&mentor_unique_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&platform_key=string&start_date=2019-08-24' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Access times heatmap data with day/hour patterns

Bodyapplication/json
day_of_weekintegerrequired
hourintegerrequired
valueintegerrequired
Response
application/json

Hourly activity patterns by day of week (0=Sunday, 1=Monday, etc.)

{
  "metric": "access_times",
  "data": [
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}

Get total time spent for current user

Request

Returns the total time spent (in seconds) for the current authenticated user. Can be filtered by platform, date range, course ID, URL, mentor UUID, and session UUID.

Query
course_idstringnon-empty

Course ID to filter by (can be partial)

end_datestring(date)

End date for time range (YYYY-MM-DD)

include_main_platformboolean

Whether to include main platform data

Default true
learner_idstringnon-empty

Username to get data for (admin users only)

mentor_uuidstringnon-empty

Mentor UUID to filter by

platformstring or nullnon-empty

Platform name or key to filter by

session_uuidstringnon-empty

Session UUID to filter by

start_datestring(date)

Start date for time range (YYYY-MM-DD)

urlstringnon-empty

URL to filter by (can be partial)

curl -i -X GET \
  'https://docs.ibl.ai/_mock/apis/ibl/api/analytics/time-spent/user/?course_id=string&end_date=2019-08-24&include_main_platform=true&learner_id=string&mentor_uuid=string&platform=string&session_uuid=string&start_date=2019-08-24&url=string'

Responses

Bodyapplication/json
total_secondsintegerrequired
Response
application/json
{
  "total_seconds": 0
}

ai-bot

Operations

ai-finetuning

Operations

ai-index

Operations

ai-marketing

Operations

ai-media

Operations

ai-mentor

Operations

ai-prompt

Operations

analytics

Operations

career

Operations

catalog

Operations

core

Operations

credentials

Operations

custom-domains

Operations

features

Operations

media

Operations

notifications

Operations

scim

Operations

commerce

Operations

recommendations

Operations

reports

Operations

skills

Operations
Copyright © ibl.ai | support@iblai.zendesk.com