Explore - Markifact

Explore Google Trends data including interest over time, interest by region, related queries, and related topics. Comparison of multiple keywords supported.


App	Google Trends
Operation ID	`google_trends_explore`
Type	Action
Connection	None
Credits per run	10
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`q`	string	No	-	Search terms (up to 5, comma-separated or newline-separated). Required for TIMESERIES when cat=0, and for GEO_MAP.
`data_type`	string or SelectableOption	Yes	-	Type of data to retrieve: TIMESERIES (Interest Over Time), GEO_MAP (Interest by Region), RELATED_QUERIES, RELATED_TOPICS
`geo`	string or SelectableOption	No	-	Geographic location for the search. Leave empty for Worldwide. Use ISO country codes (e.g., US, GB, IN) to filter by country.
`region`	string or SelectableOption	No	-	Geographic granularity for `GEO_MAP` data type: COUNTRY, REGION, DMA, CITY
`time`	string or SelectableOption	No	-	Time range for the data (e.g., ‘today 12-m’ for past 12 months)
`date_range`	DateRange	No	-	Custom date range. You must set `time` to ‘custom’ to use this field, otherwise it will be ignored.
`cat`	string or SelectableOption	No	-	Category ID to filter results. Default is 0 (All categories).
`gprop`	string or SelectableOption	No	-	Search property: `Web`, `images`, `news`, `froogle` (Shopping), `youtube`. Default is `Web`.

DateRange

Field	Type	Required	Default	Description
`start`	string	No	-	The start date of the date range to query, format: YYYY-MM-DD or dynamic node reference like {{nodeId__data.start_date}}. Required when preset is ‘FIXED’ or ‘CUSTOM’.
`end`	string	No	-	The end date of the date range to query, format: YYYY-MM-DD or dynamic node reference like {{nodeId__data.end_date}}. Required when preset is ‘FIXED’ or ‘CUSTOM’.
`preset`	string	No	-	Predefined date ranges or input modes: - Use ‘FIXED’ or leave empty when you want to specify exact dates (YYYY-MM-DD format) in start/end fields - Use ‘CUSTOM’ when you want to use dynamic values from other nodes ({{nodeId__data.start_date}} format) in start/end fields - Use other presets (TODAY, YESTERDAY, LAST_7_DAYS, etc.) for predefined date ranges (start/end will be ignored) When using ‘FIXED’ or ‘CUSTOM’, both start and end fields are required.
`compare`	CompareOptions	No	-	Optional comparison date range settings. ALWAYS use this field for comparisons; DO NOT create additional requests or nodes, as the backend returns current, comparison, and delta metrics in a single call.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

CompareOptions

Field	Type	Required	Default	Description
`start`	string	No	-	The start date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided.
`end`	string	No	-	The end date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided.
`preset`	string	No	-	Predefined comparison ranges. When provided, start and end will be ignored.
`comparison_format`	string	No	`rows`	Comparison output layout: ‘rows’ returns separate rows for current, comparison, and delta along with date ranges; ‘columns’ returns a single row with delta values only as additional _pct or _change columns depending on comparison_value_type.
`comparison_value_type`	string	No	`percentage`	Value type: ‘percentage’ or ‘absolute’

Output

Type: List[Dict] Returns Google Trends data based on the selected data type. Fields: dynamic (depend on the inputs)