Segments
Use the Segments API to fetch saved audience segments from your Bento account. This is useful when you want to inspect available segments, sync them into your own tooling, or fetch a segment's saved query before using it elsewhere.
Available Endpoints
The Segment Model
A segment is a saved audience definition based on Bento filters and events. The API returns the saved segment metadata along with the underlying visitor_event_query JSON used to define the segment.
Properties
- Name
id- Description
The segment identifier.
- Name
name- Description
The segment name.
- Name
description- Description
Optional description for the segment.
- Name
visitor_event_query- Description
The saved query definition for the segment.
- Name
created_at- Description
When the segment was created.
- Name
updated_at- Description
When the segment was last updated.
Get Segments
Returns all saved segments in your account, ordered by name.
Response
Returns a list of segment objects.
- Name
data- Description
Saved segment records.
- Name
data[].id- Description
Segment identifier.
- Name
data[].name- Description
Segment name.
- Name
data[].visitor_event_query- Description
Saved query definition for the segment.
Get Segment
Returns one saved segment by id.
Required Attributes
- Name
id- Description
The segment id to fetch.
Response
Returns the segment details, including its saved visitor_event_query.
- Name
data.id- Description
Segment identifier.
- Name
data.name- Description
Segment name.
- Name
data.description- Description
Segment description when one is set.
- Name
data.visitor_event_query- Description
Saved query definition for the segment.