Skip to content
☁️ HitKeep Cloud is coming! Join the Early Access waitlist →

Event audience breakdown

GET
/api/sites/{id}/events/audience

Returns the top pages, referrers, devices, and countries for sessions that contain the given event. All four dimensions are returned in one response (top 10 per dimension), scoped to sessions where the event fired. Optionally filter by a property value or audience dimension.

id
required
string format: uuid
from
string format: date-time
to
string format: date-time
event_name
required
string

The event name to scope audience to.

property_key
string

Optional property key. When combined with property_value, restricts to sessions where the event has this property.

property_value
string

Optional property value filter. Requires property_key.

dimension_key
string
Allowed values: path referrer device country

Optional dimension to filter sessions by. When set, only sessions where the matching hit dimension equals dimension_value are included.

dimension_value
string

Optional dimension value filter. Requires dimension_key.

Event audience breakdown

Top audience dimensions for sessions that contain a specific event.

object
top_pages

Top pages visited during event sessions (up to 10).

Array<object>
object
name
string
value
integer
top_referrers

Top referrers for event sessions (up to 10).

Array<object>
object
name
string
value
integer
top_devices

Top device types (Desktop / Mobile) for event sessions (up to 10).

Array<object>
object
name
string
value
integer
top_countries

Top countries for event sessions (up to 10). Values are ISO 3166-1 alpha-2 country codes.

Array<object>
object
name
string
value
integer