Keyword Search Interest Over Time (US, Web, Past 12 Months)

omnial/keywords-trends-explore

Given one to five keywords, returns their web search interest in the United States over the past 12 months from an independent trends dataset: one point per week with its start and end date and a 0 to 100 score per keyword (100 is the highest point of any keyword in the range), plus each keyword's average score.

activeper callv1

Price

Up to $0.00164 per call; you pay what the call used

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

Data source

DataForSEO Trends

Data from DataForSEO Trends.

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/keywords-trends-explore" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/keywords-trends-explore", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/keywords-trends-explore", 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.00164

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "keywords",
    "location_code",
    "type",
    "time_range"
  ],
  "properties": {
    "type": {
      "enum": [
        "web"
      ],
      "type": "string",
      "description": "The kind of search measured; only web is offered."
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 80,
        "minLength": 1
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "The search terms, one to five, each up to 80 characters and 10 words. Scores are relative across all the terms in one call."
    },
    "time_range": {
      "enum": [
        "past_12_months"
      ],
      "type": "string",
      "description": "The time window; only past_12_months (the last 12 months, one point per week) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The market; only 2840 (the United States) is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "data": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "values": {
                        "type": "array",
                        "items": {
                          "type": "number"
                        },
                        "description": "One score per keyword, 0 to 100, in keyword order; 100 is the highest point of any keyword in the range."
                      },
                      "date_to": {
                        "type": "string",
                        "description": "Last day of the period, YYYY-MM-DD."
                      },
                      "date_from": {
                        "type": "string",
                        "description": "First day of the period, YYYY-MM-DD."
                      },
                      "timestamp": {
                        "type": "number",
                        "description": "Start of the period, Unix seconds."
                      }
                    }
                  },
                  "description": "One point per week, oldest first."
                },
                "averages": {
                  "type": "array",
                  "items": {
                    "type": "number"
                  },
                  "description": "Each keyword's average score over the range, in keyword order."
                },
                "keywords": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "The keywords, in the order the scores use."
                }
              }
            }
          },
          "datetime": {
            "type": "string",
            "description": "When the data was retrieved (UTC)."
          },
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The keywords, in the order the scores use."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}