Segments
List segments
Your saved segments, each with the number of people in it right now (segments are evaluated on every read, never materialized), plus presets you can save as a starting point. Pass a segment id to GET /v1/people to list its members.
AuthorizationBearer <token>
API key minted via POST /v1/api-keys (format mk_live_...)
In: header
Response Body
application/json
application/json
curl -X GET "https://api.mentio.dev/v1/segments"{
"data": [
{
"id": "string",
"name": "string",
"description": "string",
"filter": {
"platforms": [
"bluesky"
],
"tags": [
"string"
],
"minFollowers": 0,
"maxFollowers": 0,
"minMentions": 1,
"minNegative": 1,
"intents": [
"string"
],
"keywordKinds": [
"brand"
],
"neverKeywordKinds": [
"brand"
],
"notPlatforms": [
"bluesky"
],
"notTags": [
"string"
],
"notIntents": [
"string"
],
"newSinceDays": 1,
"linkHosts": [
"string"
],
"muted": true,
"stages": [
"not_contacted"
],
"automated": true,
"ownerIds": [
"string"
]
},
"count": 0,
"createdAt": "string",
"updatedAt": "string"
}
],
"presets": [
{
"key": "string",
"name": "string",
"description": "string",
"filter": {
"platforms": [
"bluesky"
],
"tags": [
"string"
],
"minFollowers": 0,
"maxFollowers": 0,
"minMentions": 1,
"minNegative": 1,
"intents": [
"string"
],
"keywordKinds": [
"brand"
],
"neverKeywordKinds": [
"brand"
],
"notPlatforms": [
"bluesky"
],
"notTags": [
"string"
],
"notIntents": [
"string"
],
"newSinceDays": 1,
"linkHosts": [
"string"
],
"muted": true,
"stages": [
"not_contacted"
],
"automated": true,
"ownerIds": [
"string"
]
}
}
]
}{
"error": {
"code": "unauthorized",
"message": "string",
"requestId": "string",
"retryAfterSeconds": 0
}
}