n8n-nodes-trends
An n8n community node for accessing Google Trends data using the
@alkalisummer/google-trends-js library.
Features
This node provides access to all Google Trends API endpoints:
-
Daily Trends - Get daily trending topics for a specific region
-
Real-Time Trends - Get real-time trending topics
-
Trending Articles - Get articles related to trending topics
-
Interest Over Time - Get interest over time data for keywords
-
Autocomplete - Get search suggestions for keywords
-
Explore - Get widget data for keywords
-
Interest by Region - Get interest data by geographic region
Installation
$3
1. Go to
Settings > Community Nodes in your n8n instance
2. Enter
n8n-nodes-trends in the npm package name field
3. Click
Install
$3
1. Navigate to your n8n installation's root directory
2. Run:
npm install n8n-nodes-trends
3. Restart n8n
Usage
Once installed, you'll find the
Google Trends node in the
Transform category of your node palette.
$3
#### Daily Trends
Get daily trending topics for a specific geographic region.
Parameters:
-
Geo Location (default: "US"): Geographic location code (e.g., US, GB, DE)
-
Language (default: "en"): Language code (e.g., en, fr, de)
#### Real-Time Trends
Get currently trending topics in real-time.
Parameters:
-
Geo Location (default: "US"): Geographic location code
-
Trending Hours (default: 4): Number of hours to look back for trending topics
#### Trending Articles
Get articles related to specific trending topics.
Parameters:
-
Article Keys: JSON array of article keys (obtained from Daily Trends)
-
Article Count (default: 5): Number of articles to retrieve
#### Interest Over Time
Get interest over time data for a specific keyword.
Parameters:
-
Keyword: Search keyword (required)
-
Geo Location (default: "US"): Geographic location code
#### Autocomplete
Get search suggestions for a keyword.
Parameters:
-
Keyword: Keyword to get suggestions for (required)
-
Language (default: "en-US"): Language code
#### Explore
Get widget data for trend exploration.
Parameters:
-
Keyword: Search keyword (required)
-
Geo Location (default: "US"): Geographic location code
-
Time Range (default: "now 1-d"): Time range for analysis
-
Category (default: 0): Category number
-
Property: Property filter
-
Language (default: "en-US"): Language code
#### Interest by Region
Get interest data by geographic region.
Parameters:
-
Keywords: Comma-separated list of keywords (required)
-
Start Date: Start date for analysis
-
End Date: End date for analysis
-
Geo Locations (default: "US"): Comma-separated list of geo codes
-
Resolution (default: "REGION"): Geographic resolution (COUNTRY, REGION, CITY, DMA)
-
Language (default: "en-US"): Language code
-
Timezone (default: -240): Timezone offset in minutes
-
Category (default: 0): Category number
Example Workflows
$3
1. Add a
Manual Trigger node
2. Add the
Google Trends node
3. Set
Operation to "Daily Trends"
4. Configure
Geo Location (e.g., "US", "GB", "DE")
5. Execute to get trending topics
$3
1. Add a
Manual Trigger node
2. Add the
Google Trends node
3. Set
Operation to "Interest Over Time"
4. Enter your
Keyword (e.g., "bitcoin", "climate change")
5. Execute to get historical interest data
$3
1. Add a
Manual Trigger node
2. Add the
Google Trends node
3. Set
Operation to "Interest by Region"
4. Enter
Keywords: "electric cars"
5. Set
Geo Locations: "US,GB,DE,FR"
6. Execute to compare regional interest
Output Format
All operations return data in the following format:
``
json
{
"operation": "operationName",
"data": {
// API response data specific to the operation
}
}
`
In case of errors (when "Continue on Fail" is enabled):
`
json
{
"operation": "operationName",
"error": "Error message"
}
`
Development
$3
`
bash
npm install
npm run build
`
$3
`
bash
npm test
npm run test:watch # for watch mode
`
$3
`
bash
npm run lint
npm run lintfix # to auto-fix issues
``
Dependencies
-
n8n-workflow: Core n8n workflow functionality
-
@alkalisummer/google-trends-js: Google Trends API wrapper
License
MIT
Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Run tests and linting
6. Submit a pull request
Support
If you encounter issues or have questions:
1. Check the
Issues page
2. Create a new issue with details about your problem
3. Include n8n version, node version, and error messages
Changelog
$3
- Initial release
- Support for all Google Trends API endpoints
- Comprehensive parameter configuration
- Error handling and validation
- TypeScript support
- Jest test suite