curl "https://api.shortkit.dev/v1/events/explore?event_type=playStart&content_id=d290f1ee-6c54-4b01-90e6-d701748f0851&limit=20" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/events/explore",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
params={
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"limit": 20,
},
)
events = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/events/explore?event_type=playStart&content_id=d290f1ee-6c54-4b01-90e6-d701748f0851&limit=20",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: events, pagination } = await resp.json();
{
"data": [
{
"id": "e8f9a0b1-c2d3-4e5f-6a7b-8c9d0e1f2a3b",
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"user_id": "user_abc123",
"session_id": "sess_xyz789",
"view_session_id": "vs_a1b2c3d4",
"event_data": {},
"timestamp": "2026-03-01T12:05:30+00:00",
"received_at": "2026-03-01T12:05:31+00:00"
},
{
"id": "f0a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"user_id": "user_def456",
"session_id": "sess_abc012",
"view_session_id": "vs_e5f6g7h8",
"event_data": {},
"timestamp": "2026-03-01T12:00:00+00:00",
"received_at": "2026-03-01T12:00:01+00:00"
}
],
"pagination": {
"total": 142,
"page": 1,
"limit": 20,
"total_pages": 8
},
"timeframe": [1740787200, 1741392000],
"meta": {
"request_id": "req_evt001"
}
}
Analytics & Events
List Events
Query raw events with filtering by type, content, user, and time range.
GET
/
v1
/
events
/
explore
curl "https://api.shortkit.dev/v1/events/explore?event_type=playStart&content_id=d290f1ee-6c54-4b01-90e6-d701748f0851&limit=20" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/events/explore",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
params={
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"limit": 20,
},
)
events = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/events/explore?event_type=playStart&content_id=d290f1ee-6c54-4b01-90e6-d701748f0851&limit=20",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: events, pagination } = await resp.json();
{
"data": [
{
"id": "e8f9a0b1-c2d3-4e5f-6a7b-8c9d0e1f2a3b",
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"user_id": "user_abc123",
"session_id": "sess_xyz789",
"view_session_id": "vs_a1b2c3d4",
"event_data": {},
"timestamp": "2026-03-01T12:05:30+00:00",
"received_at": "2026-03-01T12:05:31+00:00"
},
{
"id": "f0a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"user_id": "user_def456",
"session_id": "sess_abc012",
"view_session_id": "vs_e5f6g7h8",
"event_data": {},
"timestamp": "2026-03-01T12:00:00+00:00",
"received_at": "2026-03-01T12:00:01+00:00"
}
],
"pagination": {
"total": 142,
"page": 1,
"limit": 20,
"total_pages": 8
},
"timeframe": [1740787200, 1741392000],
"meta": {
"request_id": "req_evt001"
}
}
Returns a paginated list of raw events. Use filters to narrow results by event type, content, user, or time range.
When omitted, defaults to the last 7 days.
Query parameters
string
Filter by event type (e.g.,
playStart, completion, like).string
Filter by content ID (UUID format).
string
Filter by user ID.
integer
default:50
Items per page. Min 1, max 200.
integer
default:1
Page number (1-indexed).
string
default:"7:days"
Time range filter. Format:
value:unit (e.g., 7:days, 24:hours). Defaults to the last 7 days.curl "https://api.shortkit.dev/v1/events/explore?event_type=playStart&content_id=d290f1ee-6c54-4b01-90e6-d701748f0851&limit=20" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/events/explore",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
params={
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"limit": 20,
},
)
events = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/events/explore?event_type=playStart&content_id=d290f1ee-6c54-4b01-90e6-d701748f0851&limit=20",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: events, pagination } = await resp.json();
{
"data": [
{
"id": "e8f9a0b1-c2d3-4e5f-6a7b-8c9d0e1f2a3b",
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"user_id": "user_abc123",
"session_id": "sess_xyz789",
"view_session_id": "vs_a1b2c3d4",
"event_data": {},
"timestamp": "2026-03-01T12:05:30+00:00",
"received_at": "2026-03-01T12:05:31+00:00"
},
{
"id": "f0a1b2c3-d4e5-6f7a-8b9c-0d1e2f3a4b5c",
"event_type": "playStart",
"content_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"user_id": "user_def456",
"session_id": "sess_abc012",
"view_session_id": "vs_e5f6g7h8",
"event_data": {},
"timestamp": "2026-03-01T12:00:00+00:00",
"received_at": "2026-03-01T12:00:01+00:00"
}
],
"pagination": {
"total": 142,
"page": 1,
"limit": 20,
"total_pages": 8
},
"timeframe": [1740787200, 1741392000],
"meta": {
"request_id": "req_evt001"
}
}
Pagination
Uses page-based pagination. Passpage to navigate through results. The response includes pagination.total, pagination.total_pages, and the current pagination.page. Results are ordered by timestamp descending (newest first).
Filtering by time range
Use thetimeframe[] query parameter to specify a time window:
curl "https://api.shortkit.dev/v1/events/explore?event_type=completion&timeframe[]=24:hours" \
-H "Authorization: Bearer sk_live_your_secret_key"