The segment object

A segment groups brands into a named cohort, such as Direct Competitors. Your own brand is implicit in every segment, so a segment only ever lists competitors.

Fields

Field	Type	Description
id	integer	The unique ID of the segment.
project_id	integer	The ID of the project this segment belongs to.
name	string	The display label of the segment.
project	Project	The parent project. Returned when requested via `include=project` or `include=project.organization`.
created_at	datetime	When the segment was created.
updated_at	datetime	When the segment was last updated.

Object

{
  "id": 7,
  "project_id": 42,
  "name": "Direct Competitors",
  "project": {
    "id": 42,
    "organization_id": 7,
    "name": "Acme Marketing",
    "brand_id": 555,
    "organization": {
      "id": 7,
      "name": "Acme Inc.",
      "created_at": "2026-05-15T09:11:42+00:00",
      "updated_at": "2026-05-15T09:11:42+00:00"
    },
    "created_at": "2026-05-15T09:11:42+00:00",
    "updated_at": "2026-05-15T09:11:42+00:00"
  },
  "created_at": "2026-05-18T09:11:42+00:00",
  "updated_at": "2026-05-18T09:11:42+00:00"
}