Subdomain Traffic Breakdown for a Website

{
  "type": "object",
  "required": [
    "target"
  ],
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Target to analyze: a root domain ('example.com'), subdomain ('sub.example.com'), or subfolder ('example.com/folder/')."
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Two-letter ISO 3166-1 country code to filter traffic by (e.g. 'US'). Defaults to global data."
    },
    "sort_order": {
      "type": "string",
      "minLength": 1,
      "description": "Sort column with direction suffix, e.g. 'traffic_desc'. See the report's Semrush docs for supported columns."
    },
    "device_type": {
      "enum": [
        "desktop",
        "mobile"
      ],
      "type": "string",
      "description": "Restrict to desktop or mobile traffic. Defaults to all devices."
    },
    "target_type": {
      "enum": [
        "domain",
        "subdomain",
        "subfolder"
      ],
      "type": "string",
      "description": "How to interpret `target`: domain (default), subdomain, or subfolder."
    },
    "display_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-01$",
      "description": "Snapshot month in YYYY-MM-01 format (e.g. '2026-05-01'). Min 2017-01-01, max the start of the previous month. Defaults to the previous month."
    },
    "display_limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum number of rows to return (volume only — Trends list reports bill per request, not per row). Upstream default 1000; max 5000."
    },
    "display_offset": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Number of rows to skip before returning results (pagination)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "subdomain": {
            "type": "string",
            "description": "The subdomain hostname, e.g. 'aws.amazon.com'. The target itself is included as its own row."
          },
          "total_users": {
            "type": "string",
            "description": "Estimated total unique users for the snapshot month, as an integer string."
          },
          "mobile_share": {
            "type": "string",
            "description": "Decimal-fraction string, this subdomain's share of its own traffic that is mobile. '0' and '1' both observed as exact boundary values."
          },
          "total_visits": {
            "type": "string",
            "description": "Estimated total visits for the snapshot month, as an integer string."
          },
          "desktop_share": {
            "type": "string",
            "description": "Decimal-fraction string, this subdomain's share of its own traffic that is desktop. '0' and '1' both observed as exact boundary values."
          },
          "traffic_share": {
            "type": "string",
            "description": "Decimal-fraction string, this subdomain's share of the TARGET's own total traffic (shares across all rows sum to 1 for the target, not a global rank). '1' observed for the target's own root row."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per subdomain. Empty on a target Semrush holds no traffic data for -- see examples/obscure-domain-empty.json -- which is a legitimate, low-value result, not an error."
    },
    "type": {
      "type": "string",
      "description": "Always the literal 'trends_subdomains' on both fixtures observed."
    }
  },
  "description": "The subdomain traffic breakdown, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}