{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/rumoro-dev/json-schema/rumoro-dev-segment-schema.json",
  "title": "Segment",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/rumoro-dev-segments-api-openapi.yml#/components/schemas/Segment",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The segment's 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": "The platform. Review platforms are appstore, googleplay, trustpilot and googlemaps (a place's Google reviews)."
          },
          "maxItems": 20,
          "description": "Only people with a profile on one of these platforms."
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "maxItems": 20,
          "description": "People with one of these tags."
        },
        "minFollowers": {
          "type": "integer",
          "minimum": 0,
          "description": "This many followers or more. People with an unknown count are left out."
        },
        "maxFollowers": {
          "type": "integer",
          "minimum": 0,
          "description": "This many followers or fewer. People with an unknown count are left out."
        },
        "minMentions": {
          "type": "integer",
          "minimum": 1,
          "description": "Minimum number of matched mentions."
        },
        "minNegative": {
          "type": "integer",
          "minimum": 1,
          "description": "Minimum number of negative mentions."
        },
        "intents": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "maxItems": 10,
          "description": "Has a mention tagged with one of these intents."
        },
        "keywordKinds": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "brand",
              "competitor",
              "topic"
            ]
          },
          "maxItems": 3,
          "description": "Only people with a mention of these keyword kinds."
        },
        "neverKeywordKinds": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "brand",
              "competitor",
              "topic"
            ]
          },
          "maxItems": 3,
          "description": "Excludes people who mentioned these keyword 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": "The platform. Review platforms are appstore, googleplay, trustpilot and googlemaps (a place's Google reviews)."
          },
          "maxItems": 20,
          "description": "Leaves out people who have an account on these platforms."
        },
        "notTags": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "maxItems": 20,
          "description": "Leaves out people with one of these tags."
        },
        "notIntents": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 40
          },
          "maxItems": 10,
          "description": "Excludes people with a mention of these intents."
        },
        "newSinceDays": {
          "type": "integer",
          "minimum": 1,
          "maximum": 365,
          "description": "People first seen in the past this many days."
        },
        "linkHosts": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "maxItems": 20,
          "description": "People with a mention that links to one of these hosts or its subdomains."
        },
        "muted": {
          "type": "boolean",
          "description": "true keeps only muted people and false only people who are not muted."
        },
        "stages": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "not_contacted",
              "contacted",
              "replied",
              "in_talks",
              "customer",
              "not_a_fit"
            ],
            "description": "The outreach stage your team has reached with this person."
          },
          "maxItems": 6,
          "description": "Only people in one of these outreach stages."
        },
        "automated": {
          "type": "boolean",
          "description": "true keeps people whose matched posts are mostly automated, like bots. false keeps the rest."
        },
        "ownerIds": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "maxItems": 20,
          "description": "People owned by one of these members, by user id. Use \"none\" for people without an owner."
        }
      }
    },
    "count": {
      "type": "integer",
      "minimum": 0,
      "description": "How many people are in the segment now. It is counted again on each read."
    },
    "createdAt": {
      "type": "string",
      "description": "UTC time in ISO 8601."
    },
    "updatedAt": {
      "type": "string",
      "description": "UTC time in ISO 8601."
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "filter",
    "count",
    "createdAt",
    "updatedAt"
  ]
}