mentio-dev · Schema

Segment

CompanySocial ListeningAI IntegrationSDKReal-Time Monitoring

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.
View JSON Schema on GitHub

JSON Schema

mentio-dev-segment-schema.json Raw ↑
{
  "$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.
All 92 tools →

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.