rumoro-dev · Schema

UsageBreakdown

Social ListeningArtificial IntelligenceMonitoringAnalytics

Properties

Name Type Description
window object Report range in UTC days.
by string Grouping used for the rows.
currency string All amounts are in US cents.
totals object Totals for the whole window. They are the same whatever `by` is.
data array With by=day the rows are in date order. With by=platform and by=keyword the most expensive come first, then those with the most matches, deleted keywords included.
total integer The number of rows before `limit` and `offset` are applied.
View JSON Schema on GitHub

JSON Schema

rumoro-dev-usage-breakdown-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/rumoro-dev/json-schema/rumoro-dev-usage-breakdown-schema.json",
  "title": "UsageBreakdown",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/rumoro-dev-usage-api-openapi.yml#/components/schemas/UsageBreakdown",
  "type": "object",
  "properties": {
    "window": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "description": "Start date (UTC, YYYY-MM-DD), included."
        },
        "to": {
          "type": "string",
          "description": "The last day included. It is today for a trailing range or the current month."
        },
        "days": {
          "type": "integer",
          "minimum": 0,
          "description": "How many days the window spans."
        },
        "keywordDaysFrom": {
          "type": [
            "string",
            "null"
          ],
          "description": "Earliest day in the window with a keyword count, or null. Earlier days show `keywordDays: null`."
        }
      },
      "required": [
        "from",
        "to",
        "days",
        "keywordDaysFrom"
      ],
      "description": "Report range in UTC days."
    },
    "by": {
      "type": "string",
      "enum": [
        "day",
        "platform",
        "keyword",
        "group"
      ],
      "description": "Grouping used for the rows."
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD"
      ],
      "description": "All amounts are in US cents."
    },
    "totals": {
      "type": "object",
      "properties": {
        "keywordDays": {
          "type": "integer",
          "minimum": 0,
          "description": "Sum of keyword-days over the window."
        },
        "keywordCents": {
          "type": "integer",
          "description": "Those keyword-days priced at $5 a month (500/30 cents a day), with the total rounded once."
        },
        "matchedMentions": {
          "type": "integer",
          "minimum": 0,
          "description": "Match count for the window, relevant or not."
        },
        "billableMentions": {
          "type": "integer",
          "minimum": 0,
          "description": "Matches billed in the window that fall in this row. Every scored match is billed, relevant or not."
        },
        "mentionCents": {
          "type": "integer",
          "description": "Those mentions priced at $0.008 each, with the total rounded once."
        },
        "billableComments": {
          "type": "integer",
          "minimum": 0,
          "description": "Comments billed on the comments line: comments delivered under mentions and matched replies, each once per workspace."
        },
        "commentCents": {
          "type": "integer",
          "description": "Those comments at $0.008 each, rounded once on the total."
        },
        "totalCents": {
          "type": "integer",
          "description": "keywordCents plus mentionCents plus commentCents."
        },
        "unclassifiedMentions": {
          "type": "integer",
          "minimum": 0,
          "description": "Matches whose classification failed. They are never charged."
        },
        "ledgerDebitCents": {
          "type": "integer",
          "description": "Debits recorded so far for the window's days, each on its settlement day. Mentions settle the next morning, so a window ending today trails totalCents by today's mentions, plus yesterday's before the 00:05 UTC run. A closed month differs only by cumulative rounding."
        },
        "unattributedBillable": {
          "type": "integer",
          "minimum": 0,
          "description": "Billed mentions whose match was removed with a deleted keyword, so they belong to no platform or keyword row. They were still charged."
        }
      },
      "required": [
        "keywordDays",
        "keywordCents",
        "matchedMentions",
        "billableMentions",
        "mentionCents",
        "billableComments",
        "commentCents",
        "totalCents",
        "unclassifiedMentions",
        "ledgerDebitCents",
        "unattributedBillable"
      ],
      "description": "Totals for the whole window. They are the same whatever `by` is."
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "What the row stands for. A UTC day (YYYY-MM-DD) with by=day, a platform with by=platform, a keyword id with by=keyword and a group id with by=group."
          },
          "label": {
            "type": "string",
            "description": "A name to display. The keyword's term or the group's name, or else the key."
          },
          "keyword": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The keyword's id (kw_...). Deleted keywords keep their id here."
              },
              "term": {
                "type": "string",
                "description": "The term when it was last charged, or its current term."
              },
              "removed": {
                "type": "boolean",
                "description": "The keyword was deleted later. Charges remain, but its mentions are gone, so mention counts are 0."
              }
            },
            "required": [
              "id",
              "term",
              "removed"
            ],
            "description": "Set only with by=keyword. Null otherwise."
          },
          "group": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "The group's id. It is \"none\" for keyword-days charged before groups existed when the keyword has since been deleted."
              },
              "name": {
                "type": "string",
                "description": "Current group name, or \"Deleted group\" or \"No group\"."
              },
              "removed": {
                "type": "boolean",
                "description": "True when the group was deleted later."
              }
            },
            "required": [
              "id",
              "name",
              "removed"
            ],
            "description": "Set only with by=group. Null otherwise."
          },
          "keywordDays": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "Keyword-days charged in this row by the daily run. Null with by=platform, since a keyword-day has no platform, and for days before the first recorded run, where the count is unknown rather than zero. A keyword row only counts recorded days, so before window.keywordDaysFrom it is a minimum, not zero."
          },
          "keywordCents": {
            "type": "integer",
            "description": "Those keyword-days priced at $5 a month (500/30 cents a day), with the total rounded once."
          },
          "matchedMentions": {
            "type": "integer",
            "minimum": 0,
            "description": "Match count for the window, relevant or not."
          },
          "billableMentions": {
            "type": "integer",
            "minimum": 0,
            "description": "Matches billed in the window that fall in this row. Every scored match is billed, relevant or not."
          },
          "mentionCents": {
            "type": "integer",
            "description": "Those mentions priced at $0.008 each, with the total rounded once."
          },
          "billableComments": {
            "type": "integer",
            "minimum": 0,
            "description": "Comments billed on the comments line: comments delivered under mentions and matched replies, each once per workspace."
          },
          "commentCents": {
            "type": "integer",
            "description": "Those comments at $0.008 each, rounded once on the total."
          },
          "totalCents": {
            "type": "integer",
            "description": "keywordCents plus mentionCents plus commentCents."
          }
        },
        "required": [
          "key",
          "label",
          "keyword",
          "group",
          "keywordDays",
          "keywordCents",
          "matchedMentions",
          "billableMentions",
          "mentionCents",
          "billableComments",
          "commentCents",
          "totalCents"
        ]
      },
      "description": "With by=day the rows are in date order. With by=platform and by=keyword the most expensive come first, then those with the most matches, deleted keywords included."
    },
    "total": {
      "type": "integer",
      "minimum": 0,
      "description": "The number of rows before `limit` and `offset` are applied."
    }
  },
  "required": [
    "window",
    "by",
    "currency",
    "totals",
    "data",
    "total"
  ]
}

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-usage-breakdown"
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.