Keyword Search Interest by US State (Web, Past 12 Months)

omnial/keywords-trends-subregions

Given one to five keywords, returns their web search interest across the 50 US states and the District of Columbia over the past 12 months, from an independent trends dataset: for each keyword a 0 to 100 score per state (100 is its strongest state), plus a per-state comparison giving each keyword's percentage share and its score on one shared 0 to 100 scale.

activeper callv1

Price

Up to $0.00328 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-subregions" })

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

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

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) 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": {
                "keywords": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "The keywords, in the order the scores use."
                },
                "interests": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "values": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "value": {
                              "type": "number",
                              "description": "Interest, 0 to 100; 100 is this keyword's strongest state."
                            },
                            "geo_name": {
                              "type": "string",
                              "description": "The US state, or the District of Columbia."
                            }
                          }
                        },
                        "description": "One row per state, alphabetical."
                      },
                      "keyword": {
                        "type": "string"
                      }
                    }
                  },
                  "description": "One entry per keyword."
                },
                "interests_comparison": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "values": {
                            "type": "array",
                            "items": {
                              "type": "number"
                            },
                            "description": "One number per keyword, in keyword order."
                          },
                          "geo_name": {
                            "type": "string",
                            "description": "The US state, or the District of Columbia."
                          }
                        }
                      },
                      "description": "Per state, each keyword's percentage share of the interest there; the shares sum to 100."
                    },
                    "absolute_items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "values": {
                            "type": "array",
                            "items": {
                              "type": "number"
                            },
                            "description": "One number per keyword, in keyword order."
                          },
                          "geo_name": {
                            "type": "string",
                            "description": "The US state, or the District of Columbia."
                          }
                        }
                      },
                      "description": "Per state, each keyword's interest on one shared 0 to 100 scale; 100 is the highest state score of any keyword."
                    }
                  }
                }
              }
            }
          },
          "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."
}