rumoro-dev · Schema

Segment

Social ListeningArtificial IntelligenceMonitoringAnalytics

Properties

Name Type Description
id string The segment's id (seg_...).
name string
description string
filter object
count integer How many people are in the segment now. It is counted again on each read.
createdAt string UTC time in ISO 8601.
updatedAt string UTC time in ISO 8601.
View JSON Schema on GitHub

JSON Schema

rumoro-dev-segment-schema.json Raw ↑
{
  "$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"
  ]
}

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/rumoro-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.