---
title: "Behavioral segmentation, role discovery, and exemplar matching"
method: POST
path: "/api/segmentation"
tags: ["marketing-feeds"]
---

# Behavioral segmentation, role discovery, and exemplar matching

`POST /api/segmentation`

## Request

- Base URL: `https://peopleanalyst.com`
- URL: `https://peopleanalyst.com/api/segmentation`
- Auth: none declared

Deterministic segmentation over caller-supplied numeric vectors: cluster subjects, discover roles from behaviour + relationship edges, detect emergent roles, or match against exemplars. Structured non-biometric signals only — no audio, video, or affect inference. The caller supplies all data; nothing is retained. Capped at 5,000 rows per request.

## Query parameters

- `mode` 'segment' | 'roles' | 'emergent_roles' | 'assess'

## Response `200`

{ segments[] } | { roles[] } | { matches[] } — shape depends on mode

- object

---

[API](https://skmtc.dev/peopleanalyst/apis/peopleanalyst-public-feeds.md) · [All operations](https://skmtc.dev/peopleanalyst/apis/peopleanalyst-public-feeds/llms.txt) · [OpenAPI document](https://skmtc.dev/peopleanalyst/apis/peopleanalyst-public-feeds/revisions/f369fadcfd61?raw)