Subdomain Traffic Breakdown for a Website

omnial/trends-subdomains

Given a domain, subdomain, or subfolder, lists the subdomains driving its traffic for one month: each subdomain's share of the target's total traffic, its desktop/mobile split, and estimated visits and unique users. Returns an empty list when no traffic data exists for the target.

activeper callv2

Price

$0.41 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Semrush

Data from Semrush.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/trends-subdomains" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/trends-subdomains" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/trends-subdomains", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/trends-subdomains", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.41

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "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. 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
}

Output schema

output_schema.json

{
  "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 (e.g. an obscure domain) -- which is a legitimate, low-value result, not an error."
    },
    "type": {
      "type": "string",
      "description": "Typically the literal 'trends_subdomains'."
    }
  },
  "description": "The subdomain traffic breakdown.",
  "additionalProperties": true
}