> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore

> Explore Google Trends data including interest over time, interest by region, related queries, and related topics

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)
