Monthly Search Traffic History of a Page (US Database)

omnial/page-search-traffic-history-us

Given one exact page URL, returns monthly rows of its search figures in the US search database: each row's month, how many keywords the page ranked for organically, its estimated monthly organic traffic and the estimated monthly cost of that traffic if bought as ads, and the same three figures for paid search ads.

activeper resultv1

Price

Up to $0.00273 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/page-search-traffic-history-us" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/page-search-traffic-history-us" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/page-search-traffic-history-us", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/page-search-traffic-history-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.00273

Updated: Oct 15, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "examples": [
        "https://example.com/"
      ],
      "minLength": 1,
      "description": "The exact page URL to look up, including the scheme."
    },
    "database": {
      "enum": [
        "us"
      ],
      "type": "string",
      "default": "us",
      "description": "The regional search database; only \"us\" (United States) is offered."
    },
    "display_limit": {
      "type": "integer",
      "default": 100,
      "maximum": 119,
      "minimum": 1,
      "description": "The most monthly rows to return. Defaults to 100 when left out; at most 119. A page may have fewer months of data."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "The month of this row, as YYYYMMDD (the 15th of the month)."
          },
          "adwordsCost": {
            "type": "string",
            "description": "Estimated monthly USD spend on those paid search ads, as a string."
          },
          "organicCost": {
            "type": "string",
            "description": "Estimated monthly USD cost of the organic traffic if it were bought as ads, as a string."
          },
          "adwordsTraffic": {
            "type": "string",
            "description": "Estimated monthly visits from paid search ads, as a string."
          },
          "organicTraffic": {
            "type": "string",
            "description": "Estimated monthly organic search visits to the page, as a string."
          },
          "adwordsKeywords": {
            "type": "string",
            "description": "Number of keywords the page appeared for in paid search ads that month, as a string."
          },
          "organicKeywords": {
            "type": "string",
            "description": "Number of keywords the page ranked for in organic results that month, as a string."
          }
        }
      },
      "description": "One entry per month."
    },
    "database": {
      "type": "string",
      "description": "The regional search database the figures come from (us)."
    }
  },
  "description": "The page's monthly search figures in the US database."
}