Properties
| Name | Type | Description |
|---|---|---|
| id | string | Segment id (seg_...). |
| name | string | |
| description | string | |
| filter | object | |
| groupId | stringnull | The group this segment belongs to, or null for a workspace segment. |
| count | integer | People in the segment right now; it is evaluated on every read. |
| createdAt | string | ISO 8601 timestamp, UTC. |
| updatedAt | string | ISO 8601 timestamp, UTC. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/mentio-dev/json-schema/mentio-dev-segment-schema.json",
"title": "Segment",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/mentio-dev-segments-api-openapi.yml#/components/schemas/Segment",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Segment id (seg_...)."
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"filter": {
"type": "object",
"properties": {
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"bluesky",
"hackernews",
"github",
"stackoverflow",
"devto",
"reddit",
"x",
"youtube",
"news",
"linkedin",
"tiktok",
"instagram",
"appstore",
"googleplay",
"trustpilot",
"googlemaps",
"rss"
],
"description": "Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads)."
},
"maxItems": 20,
"description": "People with an account on any of these platforms."
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 20,
"description": "People carrying any of these tags."
},
"minFollowers": {
"type": "integer",
"minimum": 0,
"description": "At least this many followers. Unknown reach never matches."
},
"maxFollowers": {
"type": "integer",
"minimum": 0,
"description": "At most this many followers. Unknown reach never matches."
},
"minMentions": {
"type": "integer",
"minimum": 1,
"description": "At least this many matched mentions."
},
"minNegative": {
"type": "integer",
"minimum": 1,
"description": "At least this many negative mentions."
},
"intents": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 10,
"description": "At least one mention carrying any of these intents."
},
"keywordKinds": {
"type": "array",
"items": {
"type": "string",
"enum": [
"brand",
"competitor",
"topic"
]
},
"maxItems": 3,
"description": "Mentioned a keyword of any of these kinds."
},
"neverKeywordKinds": {
"type": "array",
"items": {
"type": "string",
"enum": [
"brand",
"competitor",
"topic"
]
},
"maxItems": 3,
"description": "Never mentioned a keyword of these kinds."
},
"notPlatforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"bluesky",
"hackernews",
"github",
"stackoverflow",
"devto",
"reddit",
"x",
"youtube",
"news",
"linkedin",
"tiktok",
"instagram",
"appstore",
"googleplay",
"trustpilot",
"googlemaps",
"rss"
],
"description": "Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads)."
},
"maxItems": 20,
"description": "Nobody with an account on these platforms."
},
"notTags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 20,
"description": "Nobody carrying any of these tags."
},
"notIntents": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 10,
"description": "Nobody whose mentions carry any of these intents."
},
"newSinceDays": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "First seen within this many days."
},
"linkHosts": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 20,
"description": "At least one mention linking to any of these hosts, the host itself or a subdomain of it."
},
"muted": {
"type": "boolean",
"description": "true: only muted people; false: only unmuted."
},
"stages": {
"type": "array",
"items": {
"type": "string",
"enum": [
"not_contacted",
"contacted",
"replied",
"in_talks",
"customer",
"not_a_fit"
],
"description": "Where your workspace stands with the person: not_contacted, contacted, replied, in_talks, customer or not_a_fit."
},
"maxItems": 6,
"description": "People at any of these outreach stages."
},
"automated": {
"type": "boolean",
"description": "true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest."
},
"ownerIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 20,
"description": "People owned by any of these members (user ids); \"none\" matches people nobody owns."
}
}
},
"groupId": {
"type": [
"string",
"null"
],
"description": "The group this segment belongs to, or null for a workspace segment."
},
"count": {
"type": "integer",
"minimum": 0,
"description": "People in the segment right now; it is evaluated on every read."
},
"createdAt": {
"type": "string",
"description": "ISO 8601 timestamp, UTC."
},
"updatedAt": {
"type": "string",
"description": "ISO 8601 timestamp, UTC."
}
},
"required": [
"id",
"name",
"description",
"filter",
"groupId",
"count",
"createdAt",
"updatedAt"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/mentio-dev-segment"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.