Organic Keywords of a Subdomain for a Past Month (US Database)

omnial/subdomain-past-month-organic-keywords-us

For a subdomain and a past month, returns keywords it ranked for in US organic search, one per row: the keyword, its position, previous position and the change between them, search volume, cost per click, competition, the ranking URL, the share of the subdomain's traffic and traffic cost it drove, and a 12-value search interest trend. Up to 23 rows per call.

activeper resultv1

Price

Up to $0.0137 per result; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

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.

agent

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

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/subdomain-past-month-organic-keywords-us" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/subdomain-past-month-organic-keywords-us" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/subdomain-past-month-organic-keywords-us", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/subdomain-past-month-organic-keywords-us", 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 result Charged for every result returned	$0.0137

Updated: Oct 15, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "subdomain",
    "display_date"
  ],
  "properties": {
    "database": {
      "enum": [
        "us"
      ],
      "type": "string",
      "default": "us",
      "description": "Regional search database: US. The only value offered."
    },
    "subdomain": {
      "type": "string",
      "minLength": 1,
      "description": "Full subdomain (host name) to look up, without a scheme or path."
    },
    "display_date": {
      "type": "string",
      "pattern": "^\\d{6}15$",
      "description": "The past month to report on, written as YYYYMM15 (year, month, then the day 15)."
    },
    "display_limit": {
      "type": "integer",
      "default": 23,
      "maximum": 23,
      "minimum": 1,
      "description": "Number of rows to return, from 1 to 23. Default 23."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "cpc": {
            "type": "string",
            "description": "Average cost per click in US dollars, as a decimal string."
          },
          "url": {
            "type": "string",
            "description": "The subdomain's URL that ranks for the keyword."
          },
          "trends": {
            "type": "string",
            "description": "Comma-separated relative search interest for the keyword, one value per month (12 values)."
          },
          "keyword": {
            "type": "string",
            "description": "The keyword."
          },
          "position": {
            "type": "string",
            "description": "The subdomain's position for the keyword, as an integer string."
          },
          "competition": {
            "type": "string",
            "description": "Advertiser competition for the keyword, from 0 to 1, as a decimal string."
          },
          "searchVolume": {
            "type": "string",
            "description": "Monthly search volume for the keyword, as an integer string."
          },
          "trafficPercent": {
            "type": "string",
            "description": "Share of the subdomain's organic traffic from this keyword, in percent, as a decimal string."
          },
          "previousPosition": {
            "type": "string",
            "description": "The subdomain's previous position for the keyword, as an integer string; 0 when the report has none."
          },
          "positionDifference": {
            "type": "string",
            "description": "Change between the previous and current position, as an integer string; 0 when no previous position is reported."
          },
          "trafficCostPercent": {
            "type": "string",
            "description": "Share of the subdomain's organic traffic cost from this keyword, in percent, as a decimal string."
          }
        }
      },
      "description": "One ranking keyword per row, in the order the report returns them."
    },
    "database": {
      "type": "string",
      "description": "The regional search database the rows come from (us)."
    }
  },
  "description": "The subdomain's ranking keywords for the requested month in the US database."
}