Skip to content
Nappai Documentation

Google Trends

Google Trends is a tool that lets you see how popular certain keywords are over time. By entering a list of keywords, the component pulls data from Google Trends and shows you how interest in those terms has changed. This helps you decide which keywords to target for your marketing or content strategy.

How it Works

When you provide a list of keywords and a language code, the component calls the Google Trends API through a custom tool. It sends the keywords and language setting, receives the time‑series data, and then formats that data into a readable message. If you ask for a chart, the same data is returned in a format that can be plotted in the dashboard. No data is stored locally; everything is processed in real time.

Inputs

  • Keywords: List of keywords to analyze separated by commas.
  • lang_code: Language code for the search query (e.g., en-US, es-ES).

Outputs

  • Tool: A Tool object that can be used by other components to run the same Google Trends query again.
  • Response: A Message containing the raw text of the interest‑over‑time data.
  • Chart: A Message that includes the data ready to be displayed as a chart in the dashboard.

Usage Example

  1. Drag the Google Trends component onto your workflow.
  2. In the Keywords field, type artificial intelligence, machine learning.
  3. Leave lang_code as the default en-US or change it to another language.
  4. Connect the Chart output to a chart visual component to see a graph of keyword interest over time.
  5. If you need the raw data for further processing, connect the Response output to a text or data‑processing component.
  • Keyword Research – Find new keyword ideas based on search volume.
  • SEO Audit – Analyze on‑page SEO factors for a website.
  • Content Planner – Schedule content around trending keywords.

Tips and Best Practices

  • Use commas to separate multiple keywords; the component will treat each as a separate query.
  • Keep the keyword list short (5–10 terms) to avoid long response times.
  • Combine the chart output with a date range filter to focus on recent trends.
  • If you need to compare two different languages, run two separate instances of the component.

Security Considerations

The component sends your keyword list to Google’s public Trends API, which is a secure HTTPS endpoint. No sensitive personal data is transmitted. However, avoid entering confidential or proprietary terms that you do not want publicly searchable.