Skip to main content
Glama

rowfeed/google-trends-explorer

rowfeed--google-trends-explorer
Destructive

This tool calls the Actor "rowfeed/google-trends-explorer" and retrieves its output results. Actor description: Google Trends that does not break: interest over time, interest by region and top and rising related queries and topics for any keywords, up to 5 compared on one scale. Licensed data, no captchas or rate limits, pay per use.

Input Schema

NameRequiredDescriptionDefault
keywordsNoSearch terms to look up (2-100 characters each, up to 100 per run). Up to 5 are compared on one shared 0-100 scale per lookup. Example values: ["web scraping","data extraction","price tracking"]
locationNoCountry or region as Google names it, e.g. "United States", "Germany", "California,United States". Leave empty for worldwide. Example values: "United States"United States
waitSecsNoMax seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget.
timeRangeNoPeriod of the interest-over-time timeline. Example values: "past_12_months"past_12_months
searchTypeNoWhich Google property the interest is measured on. Example values: "web"web
includeRelatedNoAdd top and rising related queries and topics per keyword. Free when each keyword has its own lookup (compare off or one keyword); when keywords are compared, each keyword needs one extra lookup. Interest by region is always included. Example values: true
compareTogetherNoOn: keywords are looked up in groups of 5 sharing one 0-100 scale (like the Google Trends website). Off: every keyword gets its own 0-100 scale and its own lookup. Example values: true

Output Schema

NameRequiredDescriptionDefault
tipNoAdvisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key
runIdYesActor run ID
statsNoRun statistics
statusYesRun status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
actorIdYesStable Apify Actor ID from the run record
summaryYesPast-tense summary of the run state
exitCodeNoActor process exit code; populated for terminal states (especially FAILED)
nextStepYesOne primary follow-up action with identifiers interpolated
storagesYesDataset and key-value store metadata, keyed by alias. "default" is always the primary entry.
actorNameNo"username/actor-name"
startedAtNoISO timestamp when the run started
finishedAtNoISO timestamp when the run finished (terminal states only)
statusMessageNoPass-through from Apify run.statusMessage
apifyConsoleUrlNoPersonalized Apify Console link to the run; present only for Console sessions

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "average_interest": {
      +      "type": "number"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "compared_with": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "comparison_group": {
      +      "type": "number"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_trends_url": {
      +      "type": "string"
      +    },
      +    "has_data": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "latest_interest": {
      +      "type": "number"
      +    },
      +    "latest_period": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "peak_interest": {
      +      "type": "number"
      +    },
      +    "peak_period": {
      +      "type": "string"
      +    },
      +    "regions": {
      +      "items": {
      +        "properties": {
      +          "geo_id": {
      +            "type": "string"
      +          },
      +          "region": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_rising": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_top": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_rising": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_top": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "search_type": {
      +      "type": "string"
      +    },
      +    "time_range": {
      +      "type": "string"
      +    },
      +    "timeline": {
      +      "items": {
      +        "properties": {
      +          "date_from": {
      +            "type": "string"
      +          },
      +          "date_to": {
      +            "type": "string"
      +          },
      +          "partial": {
      +            "type": "boolean"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "trend_pct": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed3 schema fields changed
    • addedInput schema / properties / keywords / prefill
      Added value: +[
      +  "web scraping",
      +  "data extraction",
      +  "price tracking"
      +]
    • addedInput schema / properties / location / prefill
      Added value: +"United States"
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "average_interest": {
      -      "type": "number"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "compared_with": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "comparison_group": {
      -      "type": "number"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_trends_url": {
      -      "type": "string"
      -    },
      -    "has_data": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "latest_interest": {
      -      "type": "number"
      -    },
      -    "latest_period": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "peak_interest": {
      -      "type": "number"
      -    },
      -    "peak_period": {
      -      "type": "string"
      -    },
      -    "regions": {
      -      "items": {
      -        "properties": {
      -          "geo_id": {
      -            "type": "string"
      -          },
      -          "region": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_rising": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_top": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_rising": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_top": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "search_type": {
      -      "type": "string"
      -    },
      -    "time_range": {
      -      "type": "string"
      -    },
      -    "timeline": {
      -      "items": {
      -        "properties": {
      -          "date_from": {
      -            "type": "string"
      -          },
      -          "date_to": {
      -            "type": "string"
      -          },
      -          "partial": {
      -            "type": "boolean"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "trend_pct": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  3. Changed2 schema fields changed
    • addedInput schema / description
      Added value: +"Live lookups need a paid Apify plan (any plan). The pre-filled example works on the free plan."
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "average_interest": {
      +      "type": "number"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "compared_with": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "comparison_group": {
      +      "type": "number"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_trends_url": {
      +      "type": "string"
      +    },
      +    "has_data": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "latest_interest": {
      +      "type": "number"
      +    },
      +    "latest_period": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "peak_interest": {
      +      "type": "number"
      +    },
      +    "peak_period": {
      +      "type": "string"
      +    },
      +    "regions": {
      +      "items": {
      +        "properties": {
      +          "geo_id": {
      +            "type": "string"
      +          },
      +          "region": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_rising": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_top": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_rising": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_top": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "search_type": {
      +      "type": "string"
      +    },
      +    "time_range": {
      +      "type": "string"
      +    },
      +    "timeline": {
      +      "items": {
      +        "properties": {
      +          "date_from": {
      +            "type": "string"
      +          },
      +          "date_to": {
      +            "type": "string"
      +          },
      +          "partial": {
      +            "type": "boolean"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "trend_pct": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  4. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "average_interest": {
      -      "type": "number"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "compared_with": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "comparison_group": {
      -      "type": "number"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_trends_url": {
      -      "type": "string"
      -    },
      -    "has_data": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "latest_interest": {
      -      "type": "number"
      -    },
      -    "latest_period": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "peak_interest": {
      -      "type": "number"
      -    },
      -    "peak_period": {
      -      "type": "string"
      -    },
      -    "regions": {
      -      "items": {
      -        "properties": {
      -          "geo_id": {
      -            "type": "string"
      -          },
      -          "region": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_rising": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_top": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_rising": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_top": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "search_type": {
      -      "type": "string"
      -    },
      -    "time_range": {
      -      "type": "string"
      -    },
      -    "timeline": {
      -      "items": {
      -        "properties": {
      -          "date_from": {
      -            "type": "string"
      -          },
      -          "date_to": {
      -            "type": "string"
      -          },
      -          "partial": {
      -            "type": "boolean"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "trend_pct": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  5. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "average_interest": {
      +      "type": "number"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "compared_with": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "comparison_group": {
      +      "type": "number"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_trends_url": {
      +      "type": "string"
      +    },
      +    "has_data": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "latest_interest": {
      +      "type": "number"
      +    },
      +    "latest_period": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "peak_interest": {
      +      "type": "number"
      +    },
      +    "peak_period": {
      +      "type": "string"
      +    },
      +    "regions": {
      +      "items": {
      +        "properties": {
      +          "geo_id": {
      +            "type": "string"
      +          },
      +          "region": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_rising": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_top": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_rising": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_top": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "search_type": {
      +      "type": "string"
      +    },
      +    "time_range": {
      +      "type": "string"
      +    },
      +    "timeline": {
      +      "items": {
      +        "properties": {
      +          "date_from": {
      +            "type": "string"
      +          },
      +          "date_to": {
      +            "type": "string"
      +          },
      +          "partial": {
      +            "type": "boolean"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "trend_pct": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  6. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "average_interest": {
      -      "type": "number"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "compared_with": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "comparison_group": {
      -      "type": "number"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_trends_url": {
      -      "type": "string"
      -    },
      -    "has_data": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "latest_interest": {
      -      "type": "number"
      -    },
      -    "latest_period": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "peak_interest": {
      -      "type": "number"
      -    },
      -    "peak_period": {
      -      "type": "string"
      -    },
      -    "regions": {
      -      "items": {
      -        "properties": {
      -          "geo_id": {
      -            "type": "string"
      -          },
      -          "region": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_rising": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_top": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_rising": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_top": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "search_type": {
      -      "type": "string"
      -    },
      -    "time_range": {
      -      "type": "string"
      -    },
      -    "timeline": {
      -      "items": {
      -        "properties": {
      -          "date_from": {
      -            "type": "string"
      -          },
      -          "date_to": {
      -            "type": "string"
      -          },
      -          "partial": {
      -            "type": "boolean"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "trend_pct": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  7. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "average_interest": {
      +      "type": "number"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "compared_with": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "comparison_group": {
      +      "type": "number"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_trends_url": {
      +      "type": "string"
      +    },
      +    "has_data": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "latest_interest": {
      +      "type": "number"
      +    },
      +    "latest_period": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "peak_interest": {
      +      "type": "number"
      +    },
      +    "peak_period": {
      +      "type": "string"
      +    },
      +    "regions": {
      +      "items": {
      +        "properties": {
      +          "geo_id": {
      +            "type": "string"
      +          },
      +          "region": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_rising": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_top": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_rising": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_top": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "search_type": {
      +      "type": "string"
      +    },
      +    "time_range": {
      +      "type": "string"
      +    },
      +    "timeline": {
      +      "items": {
      +        "properties": {
      +          "date_from": {
      +            "type": "string"
      +          },
      +          "date_to": {
      +            "type": "string"
      +          },
      +          "partial": {
      +            "type": "boolean"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "trend_pct": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  8. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "average_interest": {
      -      "type": "number"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "compared_with": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "comparison_group": {
      -      "type": "number"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_trends_url": {
      -      "type": "string"
      -    },
      -    "has_data": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "latest_interest": {
      -      "type": "number"
      -    },
      -    "latest_period": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "peak_interest": {
      -      "type": "number"
      -    },
      -    "peak_period": {
      -      "type": "string"
      -    },
      -    "regions": {
      -      "items": {
      -        "properties": {
      -          "geo_id": {
      -            "type": "string"
      -          },
      -          "region": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_rising": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_top": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_rising": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_top": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "search_type": {
      -      "type": "string"
      -    },
      -    "time_range": {
      -      "type": "string"
      -    },
      -    "timeline": {
      -      "items": {
      -        "properties": {
      -          "date_from": {
      -            "type": "string"
      -          },
      -          "date_to": {
      -            "type": "string"
      -          },
      -          "partial": {
      -            "type": "boolean"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "trend_pct": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  9. Changed1 schema field changed
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Added value: +{
      +  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      +  "properties": {
      +    "average_interest": {
      +      "type": "number"
      +    },
      +    "checked_at": {
      +      "type": "string"
      +    },
      +    "compared_with": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "comparison_group": {
      +      "type": "number"
      +    },
      +    "from_snapshot": {
      +      "type": "boolean"
      +    },
      +    "google_trends_url": {
      +      "type": "string"
      +    },
      +    "has_data": {
      +      "type": "boolean"
      +    },
      +    "keyword": {
      +      "type": "string"
      +    },
      +    "latest_interest": {
      +      "type": "number"
      +    },
      +    "latest_period": {
      +      "type": "string"
      +    },
      +    "location": {
      +      "type": "string"
      +    },
      +    "peak_interest": {
      +      "type": "number"
      +    },
      +    "peak_period": {
      +      "type": "string"
      +    },
      +    "regions": {
      +      "items": {
      +        "properties": {
      +          "geo_id": {
      +            "type": "string"
      +          },
      +          "region": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_rising": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_queries_top": {
      +      "items": {
      +        "properties": {
      +          "query": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_rising": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "related_topics_top": {
      +      "items": {
      +        "properties": {
      +          "topic": {
      +            "type": "string"
      +          },
      +          "type": {
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "search_type": {
      +      "type": "string"
      +    },
      +    "time_range": {
      +      "type": "string"
      +    },
      +    "timeline": {
      +      "items": {
      +        "properties": {
      +          "date_from": {
      +            "type": "string"
      +          },
      +          "date_to": {
      +            "type": "string"
      +          },
      +          "partial": {
      +            "type": "boolean"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "trend_pct": {
      +      "type": "number"
      +    }
      +  },
      +  "type": "object"
      +}
  10. Changed1 schema field changed
    • removedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema
      Removed value: -{
      -  "description": "JSON Schema for rows in the dataset at `storages.datasets.default.id` — describes row shape only; the rows themselves are NOT returned inline in this response. Inferred from this Actor's historical successful runs. To fetch actual rows, call `get-dataset-items` with the dataset id and a `fields` projection drawn from this schema.",
      -  "properties": {
      -    "average_interest": {
      -      "type": "number"
      -    },
      -    "checked_at": {
      -      "type": "string"
      -    },
      -    "compared_with": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "type": "array"
      -    },
      -    "comparison_group": {
      -      "type": "number"
      -    },
      -    "from_snapshot": {
      -      "type": "boolean"
      -    },
      -    "google_trends_url": {
      -      "type": "string"
      -    },
      -    "has_data": {
      -      "type": "boolean"
      -    },
      -    "keyword": {
      -      "type": "string"
      -    },
      -    "latest_interest": {
      -      "type": "number"
      -    },
      -    "latest_period": {
      -      "type": "string"
      -    },
      -    "location": {
      -      "type": "string"
      -    },
      -    "peak_interest": {
      -      "type": "number"
      -    },
      -    "peak_period": {
      -      "type": "string"
      -    },
      -    "regions": {
      -      "items": {
      -        "properties": {
      -          "geo_id": {
      -            "type": "string"
      -          },
      -          "region": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_rising": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_queries_top": {
      -      "items": {
      -        "properties": {
      -          "query": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_rising": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "related_topics_top": {
      -      "items": {
      -        "properties": {
      -          "topic": {
      -            "type": "string"
      -          },
      -          "type": {
      -            "type": "string"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "search_type": {
      -      "type": "string"
      -    },
      -    "time_range": {
      -      "type": "string"
      -    },
      -    "timeline": {
      -      "items": {
      -        "properties": {
      -          "date_from": {
      -            "type": "string"
      -          },
      -          "date_to": {
      -            "type": "string"
      -          },
      -          "partial": {
      -            "type": "boolean"
      -          },
      -          "value": {
      -            "type": "number"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "type": "array"
      -    },
      -    "trend_pct": {
      -      "type": "number"
      -    }
      -  },
      -  "type": "object"
      -}
  11. Changed6 schema fields changed
    • addedInput schema / properties / includeRelated
      Added value: +{
      +  "default": true,
      +  "description": "Add top and rising related queries and topics per keyword. Free when each keyword has its own lookup (compare off or one keyword); when keywords are compared, each keyword needs one extra lookup. Interest by region is always included.\nExample values: true",
      +  "examples": [
      +    true
      +  ],
      +  "title": "Related queries and topics",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / regions
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "geo_id": {
      +        "type": "string"
      +      },
      +      "region": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / related_queries_rising
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "query": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / related_queries_top
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "query": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / related_topics_rising
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "topic": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / storages / properties / datasets / properties / default / properties / itemsSchema / properties / related_topics_top
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "topic": {
      +        "type": "string"
      +      },
      +      "type": {
      +        "type": "string"
      +      },
      +      "value": {
      +        "type": "number"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  12. First observed

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds genuinely useful behavior beyond the annotations: 'pay per use' cost model, 'licensed data, no captchas or rate limits', and the shared 0-100 comparison scale. However, with destructiveHint=true and readOnlyHint=false supplied, the description never explains what the run writes or persists, nor how the Actor-run lifecycle (waitSecs cap, polling) behaves. It adds cost/reliability context but leaves the write-side behavior opaque.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, but the first is boilerplate MCP-wrapper phrasing ('This tool calls the Actor ... and retrieves its output results') that conveys nothing an agent cannot infer. The second sentence is a dense run-on packing scale limits, data licensing, and pricing into one clause chain, so it is compact but not well structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and 100% parameter coverage, the description only needs to carry purpose and key behavior, which it mostly does. The gaps are sibling differentiation and the meaning of the destructive/write annotations for a scraping run. Adequate but not complete for a tool sitting among 40+ similar scrapers.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so every one of the 7 parameters is already fully documented, including waitSecs polling semantics and the includeRelated cost note. The description restates the 'up to 5 compared on one scale' rule that compareTogether already explains, adding no new syntax or constraint information. Baseline 3 applies when the schema carries the burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names the concrete resource (Google Trends data) and enumerates the specific outputs: interest over time, interest by region, and top/rising related queries and topics. This distinguishes it from siblings such as rowfeed--keyword-search-volume or rowfeed--google-serp-api. The opening wrapper sentence ('calls the Actor ... and retrieves its output results') is generic, but the quoted actor description supplies real specificity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no when-to-use or when-not guidance and no routing to alternatives among the ~40 sibling tools. The description never says whether to pick this over keyword-search-volume for demand data or google-news-monitor for news interest. Usage is only inferable from the domain ('Google Trends').

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.