Events
List raw event records and grouped time series data for the requested date range.
curl -X GET "https://api.nexus.usehardal.com/analytics/events/?timezone=example_string&eventName=John%20Doe&targetSignalId=example_string&sampleSize=example_string&limit=example_string&offset=example_string&interval=minute&selectedEvents=%5B%22example_string%22%5D¬SelectedEvents=%5B%22example_string%22%5D&timeframe=today&startDate=example_string&endDate=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: YOUR_API_KEY"
import requests
import json
url = "https://api.nexus.usehardal.com/analytics/events/?timezone=example_string&eventName=John%20Doe&targetSignalId=example_string&sampleSize=example_string&limit=example_string&offset=example_string&interval=minute&selectedEvents=%5B%22example_string%22%5D¬SelectedEvents=%5B%22example_string%22%5D&timeframe=today&startDate=example_string&endDate=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.nexus.usehardal.com/analytics/events/?timezone=example_string&eventName=John%20Doe&targetSignalId=example_string&sampleSize=example_string&limit=example_string&offset=example_string&interval=minute&selectedEvents=%5B%22example_string%22%5D¬SelectedEvents=%5B%22example_string%22%5D&timeframe=today&startDate=example_string&endDate=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.nexus.usehardal.com/analytics/events/?timezone=example_string&eventName=John%20Doe&targetSignalId=example_string&sampleSize=example_string&limit=example_string&offset=example_string&interval=minute&selectedEvents=%5B%22example_string%22%5D¬SelectedEvents=%5B%22example_string%22%5D&timeframe=today&startDate=example_string&endDate=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.nexus.usehardal.com/analytics/events/?timezone=example_string&eventName=John%20Doe&targetSignalId=example_string&sampleSize=example_string&limit=example_string&offset=example_string&interval=minute&selectedEvents=%5B%22example_string%22%5D¬SelectedEvents=%5B%22example_string%22%5D&timeframe=today&startDate=example_string&endDate=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"success": true,
"data": {
"rawEvents": [
{
"event_id": "06ebd57c-c898-4266-bd67-b55558f192b1",
"session_id": "sess_f346ae641883_2",
"created_at": "2026-06-30 14:23:13",
"event_name": "identify",
"url": "https://demo.usehardal.com/products/electronics?utm_source=google&utm_medium=cpc&utm_campaign=22998822939",
"referrer_domain": "youtube.com",
"hostname": "demo.usehardal.com",
"browser": "Chrome",
"os": "Android",
"device": "mobile",
"country": "Sweden",
"source": "google",
"medium": "cpc",
"campaign": "20455322391",
"channel": "PaidSearch"
},
{
"event_id": "2d0a3b7b-602e-4581-b1ff-6c30cb981998",
"session_id": "sess_f346ae641883_2",
"created_at": "2026-06-30 14:23:13",
"event_name": "page_view",
"url": "https://demo.usehardal.com/products/electronics?utm_source=google&utm_medium=cpc&utm_campaign=22998822939",
"referrer_domain": "youtube.com",
"hostname": "demo.usehardal.com",
"browser": "Chrome",
"os": "Android",
"device": "mobile",
"country": "Sweden",
"source": "google",
"medium": "cpc",
"campaign": "20455322391",
"channel": "PaidSearch"
},
{
"event_id": "a0d12bed-1e8b-4c0b-b982-5b268897ccb6",
"session_id": "sess_838cdc7f39f0_3",
"created_at": "2026-06-30 14:23:13",
"event_name": "page_view",
"url": "https://demo.usehardal.com/products/apparel?utm_source=sm&utm_medium=genel&utm_campaign=Conversion_All_Remarketing",
"referrer_domain": "google.com",
"hostname": "demo.usehardal.com",
"browser": "Safari",
"os": "iOS",
"device": "mobile",
"country": "Germany",
"source": "google",
"medium": "organic",
"campaign": "",
"channel": "OrganicSearch"
}
],
"timeSeries": {
"begin_checkout": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 51
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 46
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 46
}
],
"add_to_wishlist": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 20
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 22
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 19
}
],
"identify": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 5154
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 5104
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 5093
}
],
"view_item_list": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 119
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 105
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 115
}
],
"search": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 83
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 86
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 76
}
],
"view_item": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 170
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 167
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 185
}
],
"refund": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 17
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 16
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 8
}
],
"view_cart": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 71
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 60
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 54
}
],
"page_view": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 4257
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 4216
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 4211
}
],
"add_payment_info": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 34
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 32
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 44
}
],
"view_promotion": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 51
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 60
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 60
}
],
"purchase": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 16
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 24
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 25
}
],
"select_promotion": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 46
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 35
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 38
}
],
"remove_from_cart": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 21
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 17
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 24
}
],
"add_shipping_info": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 25
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 44
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 27
}
],
"select_item": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 112
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 98
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 91
}
],
"add_to_cart": [
{
"date": "2026-06-30 00:00:00",
"eventCount": 64
},
{
"date": "2026-06-30 01:00:00",
"eventCount": 73
},
{
"date": "2026-06-30 02:00:00",
"eventCount": 70
}
],
"hardal_monitoring_ufch5hu1k8q": [
{
"date": "2026-06-30 14:00:00",
"eventCount": 1
}
]
}
},
"timestamp": "2026-06-30T12:11:05.513Z",
"path": "/analytics/events/"
}
GET
/analytics/events/
GET
Base URLstring
Target server for requests. Edit to use your own host.
API Key (header: Authorization)
Authorizationstring
RequiredAPI key (sent in header)
query
timezonestring
Timezone for date filtering (default: Europe/Istanbul)
query
eventNamestring
Filter metrics by a specific event name
query
targetSignalIdstring
Target signal ID for comparison
query
sampleSizestring
Number of event samples to return (default: 1, max: 5)
query
limitstring
Number of records to return for raw events (default: 20, max: 1000)
Min: 1 • Max: 1000
query
offsetstring
Number of records to skip for raw events pagination (default: 0, max: 10000)
Min: 0 • Max: 10000
query
intervalstring
Interval for time series aggregation (minute, hour, day, week, month)
Options: minute, hour, day, week, month
query
timeframestring
RequiredRequired preset timeframe for the query. Use custom together with startDate and endDate when querying a custom date range.
Options: today, yesterday, last7days, last30days, custom
query
startDatestring
Start date (YYYY-MM-DD)
query
endDatestring
End date (YYYY-MM-DD)
Request Preview
Response
Response will appear here after sending the request
Authentication
header
Authorizationstring
RequiredAPI Key for authentication. Provide your API key in the header.
Query Parameters
timezonestring
Timezone for date filtering (default: Europe/Istanbul)
eventNamestring
Filter metrics by a specific event name
targetSignalIdstring
Target signal ID for comparison
sampleSizestring
Number of event samples to return (default: 1, max: 5)
limitstring
Number of records to return for raw events (default: 20, max: 1000)
offsetstring
Number of records to skip for raw events pagination (default: 0, max: 10000)
intervalstring
Interval for time series aggregation (minute, hour, day, week, month)
Allowed values:
minutehourdayweekmonthtimeframestring
RequiredRequired preset timeframe for the query. Use custom together with startDate and endDate when querying a custom date range.
Allowed values:
todayyesterdaylast7dayslast30dayscustomstartDatestring
Start date (YYYY-MM-DD)
endDatestring
End date (YYYY-MM-DD)
Responses
Successful response.
Was this page helpful?