Scrapeless Official icon

Scrapeless Official

Official Scrapeless nodes for n8n

Actions5

Overview

The node provides access to Google Trends data through the Scrapeless Official integration. It allows users to query various types of Google Trends information such as autocomplete suggestions, interest over time, regional breakdowns, related queries, and related topics. This node is useful for marketers, researchers, and analysts who want to track search trends, compare interest in different topics, or gather insights about regional popularity and related search terms.

Practical examples include:

  • Monitoring how interest in competing car brands changes over time.
  • Comparing regional interest in multiple products or keywords.
  • Extracting autocomplete suggestions to enhance SEO keyword lists.
  • Discovering related queries and topics to expand content strategies.

Properties

Name Meaning
Search Query The search term(s) to query on Google Trends. Up to 5 queries can be used for certain data types (interest_over_time and compared_breakdown_by_region). For other data types, only one query is accepted.
Data Type The type of Google Trends data to retrieve. Options: autocomplete, interest_over_time, compared_breakdown_by_region, interest_by_subregion, related_queries, related_topics.
Date The date range for the trends data. Supports predefined ranges like now 1-H, today 1-m, all, or custom date ranges in formats like yyyy-mm-dd yyyy-mm-dd or with hours yyyy-mm-ddThh yyyy-mm-ddThh.
Language Two-letter language code (e.g., en, es, fr) specifying the language for the Google Trends search.
Time zone Time zone offset as a string (default is "420"). Used to calculate hourly data within date ranges.
Location Geographic location code to specify where the search originates from. Defaults to worldwide if empty. Includes country codes like US, GB, DE, etc.
Category Numeric category ID to filter the search by specific categories (e.g., 0 for all categories, 3 for Arts & Entertainment, 7 for Finance, etc.). A very extensive list of categories is available to narrow down the search context.
Property Filters results by property type. Default is Web Search if empty. Other options include images (Image Search), news (News Search), froogle (Google Shopping), and youtube (YouTube Search).

Output

The node outputs JSON data containing the requested Google Trends information based on the selected data type and parameters. The structure varies depending on the data type but generally includes trend metrics, timestamps, regions, related queries, or autocomplete suggestions.

If binary data were supported, it would typically represent media files or images, but this node focuses on JSON trend data.

Dependencies

  • Requires an API key credential for the Scrapeless service to authenticate requests.
  • No additional environment variables are explicitly required.
  • The node depends on the Scrapeless API backend to fetch Google Trends data.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Using more than 5 queries for data types that support only single queries will result in errors.
    • Incorrect date format or unsupported date ranges may cause request failures.
    • Selecting incompatible combinations of properties and data types might yield empty or unexpected results.

  • Error messages:

    • Authentication errors indicate invalid or missing API keys; verify and update credentials.
    • Parameter validation errors suggest incorrect input values; check the query count, date format, and allowed options.
    • Network or API errors may occur due to Scrapeless service downtime or connectivity issues; retry later or check service status.

Links and References

  • Google Trends
  • Scrapeless official documentation (not publicly linked here)
  • Google Trends API usage guidelines and best practices

Discussion