Google Trends API - Interest Over Time, Regions & Queries โœ… avatar

Google Trends API - Interest Over Time, Regions & Queries โœ…

Pricing

from $12.00 / 1,000 keyword reports

Go to Apify Store
Google Trends API - Interest Over Time, Regions & Queries โœ…

Google Trends API - Interest Over Time, Regions & Queries โœ…

Google Trends API: interest over time, regions, related queries and topics for any keyword, plus a summary row. Compare up to 5 keywords on one scale. No browser, no captchas. Web, News, YouTube, Images, Shopping. A Google Trends scraper with free no-data keywords. CSV, Excel, JSON, API.

Pricing

from $12.00 / 1,000 keyword reports

Rating

5.0

(3)

Developer

Unseen User

Unseen User

Maintained by Community

Actor stats

0

Bookmarked

3

Total users

3

Monthly active users

5 hours ago

Last modified

Categories

Share

๐Ÿ“ˆ Google Trends API & Scraper - Interest Over Time, Regions & Related Queries

Google Trends for any keyword, as clean spreadsheet rows: interest over time, interest by country or region, related topics and related queries, plus a one-row summary per keyword. Compare up to 5 keywords on one scale. No browser, no failed runs from blocked pages.

Use it as a Google Trends API: send keywords from the Apify Console, the API, Python or an AI agent, and get Google search trends back as rows you can chart, compare and schedule.

โšก Why This Actor?

Google Trends data for any keyword, delivered as clean rows you can open straight in a spreadsheet. Each keyword gets a full report in one run:

  • Summary row - average interest, peak date and value, latest value, a rising/falling/stable label, the top related query, the fastest-rising query and the top region
  • Interest over time - one row per week, day or hour, 0-100, with a flag on the latest partial period
  • Interest by region - one row per country (or per state/region when you pick a country)
  • Related queries - top and rising, with rising growth as a label like +8,200%
  • Related topics - top and rising, with topic type

Compare up to 5 keywords on one shared 0-100 scale, the same way the Google Trends website does, with interest by region for each keyword.

Search web, news, YouTube, images or Google Shopping trends, worldwide or in one country, from the past hour to all data since 2004. Every row links to the matching chart on Google Trends (checkUrl).

No browser, no blocked pages. The data comes from a data API, not from loading the Google Trends website, so runs do not fail on captchas or page changes.

This Actor returns Google Trends data only. It does NOT return absolute search volumes (Google Trends values are relative, 0-100), keyword suggestions, trending-now lists, or any personal data.

๐ŸŽฏ Use Cases

  • Content and SEO planning - see which topics are rising before you write, and pick related queries to target
  • Seasonality - find when interest peaks each year to time launches, stock and campaigns
  • Product research - compare up to 5 products or brands on one scale and see where each one is strongest
  • Market entry - check interest by country or region before you expand
  • Brand monitoring - track your brand against competitors week by week on a schedule
  • Reporting and dashboards - flat rows go straight into Sheets, Looker Studio, Excel or a database
  • AI agents and automation - call it through the Apify API or MCP to give an agent fresh trend data
  • Google Trends API for developers - pull Google Trends data into Python, JavaScript or any HTTP client through the Apify API, with no scraping code to maintain
  • YouTube and shopping trends - switch the search type to YouTube or Google Shopping to see what people search for there

๐Ÿš€ Quick Start

  1. Click Try for free on this Actor's page
  2. Enter one or more keywords (or up to 5 keywords to compare)
  3. Pick a search type, country and time range, or keep the defaults (web, worldwide, past 12 months)
  4. Run the Actor and download the results as JSON, CSV or Excel, or pull them via the Apify API

โš™๏ธ Inputs Overview

InputTypeRequiredDescriptionExample/Allowed Values
keywordsarray of stringsโŒ (this or compareKeywords)Keywords to report on, 1 to 200 per run. Each keyword gets its own full report on its own 0-100 scale.["air fryer", "standing desk"]
compareKeywordsarray of stringsโŒ (this or keywords)2 to 5 keywords compared on one shared 0-100 scale (interest over time + regions).["air fryer", "instant pot", "rice cooker"]
searchTypeselectโŒweb (default), news, youtube, images, shoppingweb
countryselectโŒWorldwide (default) or one country. With a country, regions are states/provinces.United States
timeRangeselectโŒpast_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months (default), past_5_years, all_time (2004 for web, 2008 for other search types)past_12_months
dataSetsmulti-selectโŒWhich data sets to include in keyword reports: interest_over_time, regions, related_queries, related_topics. Default: all four.all four

Keywords can be up to 100 characters and cannot contain < > | " - + = ~ ! : * ( ) [ ] { }. Keywords that break these rules get a free INVALID_KEYWORD row and are never sent.

Example input

{
"keywords": ["google trends api", "google trends scraper", "google trends data"],
"compareKeywords": ["google trends api", "google trends scraper", "google trends data"],
"searchType": "web",
"country": "Worldwide",
"timeRange": "past_12_months",
"dataSets": ["interest_over_time", "regions", "related_queries", "related_topics"]
}

๐Ÿ’ฐ Pricing

Pay-per-event model on Apify. You pay per keyword report, never per row.

EventPriceWhen it is charged
apify-actor-start$0.02 per runOnce per run (Apify's standard start event)
keyword-report$0.012 per keyword ($12 per 1,000)Once per keyword that returned data, however many rows it produced
comparison$0.012 per comparison (2-5 keywords)Once per comparison that returned data

Never charged: keywords with no data (NO_DATA), invalid keywords, error rows, and any other information row.

Worked examples

RunCharged eventsTotal
1 keyword, all 4 data sets1 report$0.032
5-keyword comparison1 comparison$0.032
100 keywords100 reports$1.22
1,000 keywords (5 runs of 200)1,000 reports$12.10

(Each run = $0.02 start + $0.012 per report or comparison with data.)

Compare mode puts up to 5 keywords on one chart.

See exact per-event pricing on the Actor's Apify page.

Free plan limit: Free Apify plan: up to 5 results per run; paid plans: no limit. See Free Plan Limit below.

๐Ÿ†“ Free Plan Limit

NOTE: Free Apify users receive up to 5 results per run. Upgrade to any paid Apify plan to remove this limit. This limit was set by the Actor developer, not by Apify.

On the free plan, only the first keyword (or the comparison, if you entered no single keywords) is processed, the run returns up to 5 rows starting with the summary row, and it stops at the first keyword with no data.

๐Ÿ“Š Output Fields

Every row has a type and these shared fields:

FieldTypeDescription
typestringsummary, interest_over_time, region, related_query or related_topic
keywordstringThe keyword this row is about
comparisonGrouparray or nullThe compared keywords, for comparison rows; null for single-keyword reports
searchTypestringweb, news, youtube, images or shopping
countrystringWorldwide or the country name
timeRangestringThe time range used
checkUrlstringLink to the same chart on Google Trends
scrapedAtstring (ISO 8601)When the row was collected

summary (one per keyword; first row of each report):

FieldTypeDescription
averageInterestnumberAverage 0-100 interest over the time range
peakInterestnumberHighest value in the range (100 on its own scale)
peakDatestringDate of the peak
latestInterestnumber or nullLatest complete period's value
trendDirectionstringrising, falling or stable (see FAQ)
topRelatedQuerystring or nullFirst top related query
topRisingQuerystring or nullFirst rising related query
topRegionstring or nullRegion with the highest interest

interest_over_time (one per date per keyword): date (ISO 8601, built from the source timestamp), value (0-100), isPartial (true for the latest incomplete period).

region (one per country or region with data): regionCode (e.g. US-OK), regionName, value (0-100). Regions with no data are left out.

related_query: listType (top or rising), query, value, valueLabel (top: the 0-100 value; rising: growth like +8,200%).

related_topic: listType (top or rising), topicTitle, topicType, topicId, value, valueLabel.

Comparison rows: one summary per keyword, interest_over_time rows for every keyword on the shared scale, and region rows per keyword. Related queries and topics are not part of comparisons: Google Trends shows them for one keyword at a time.

Information and error rows (never charged)

error.typeWhenWhat happens
NO_DATAGoogle Trends has no data for this keyword (too few searches)One row for that keyword; the run continues (free plan: the run stops)
INVALID_KEYWORDThe keyword is too long or has a disallowed characterOne row; the keyword is never sent
INVALID_INPUTNo keywords, too many, a comparison with fewer than 2 or more than 5 keywords, or a country that is not availableOne row; the run ends
NOT_READYThe data for one keyword was not ready in time, or could not be loaded from the data sourceOne row for that keyword; run it again later
FREE_PLAN_LIMITThe free plan's 5-result limit was reachedOne row; the run stops
FREE_PLAN_NO_RESULTSFree plan: the first keyword had no dataOne row; the run stops
MAX_CHARGE_REACHEDYour "Maximum cost per run" was reachedOne row (if the platform still allows it); the run stops
SOURCE_UNAVAILABLEThe data source was temporarily unavailableOne row; the run stops

Shape: { "status": "error" or "info", "keyword": "...", "error": { "type": "...", "message": "..." }, "charged": false }

Example rows (from a live test, air fryer, worldwide, past 12 months)

{ "type": "interest_over_time", "keyword": "air fryer", "comparisonGroup": null, "searchType": "web", "country": "Worldwide", "timeRange": "past_12_months", "date": "2025-10-19T00:00:00.000Z", "value": 53, "isPartial": false, "checkUrl": "https://trends.google.com/trends/explore?hl=en&date=today%2012-m&q=air%20fryer", "scrapedAt": "2026-10-22T11:42:57.000Z" }
{ "type": "related_query", "keyword": "air fryer", "listType": "top", "query": "air fryer ninja", "value": 100, "valueLabel": "100" }
{ "type": "related_query", "keyword": "air fryer", "listType": "rising", "query": "ninja crispi pro air fryer", "value": 4750, "valueLabel": "+4,750%" }
{ "type": "related_topic", "keyword": "air fryer", "listType": "top", "topicTitle": "Deep fryer", "topicType": "Topic", "topicId": "/m/0423gr", "value": 86, "valueLabel": "86" }

(Shared fields shortened after the first row for readability.)

{ "type": "summary", "keyword": "google trends api", "comparisonGroup": null, "searchType": "web", "country": "Worldwide", "timeRange": "past_12_months", "checkUrl": "https://trends.google.com/trends/explore?hl=en&date=today%2012-m&q=google%20trends%20api", "scrapedAt": "2026-10-22T16:20:45.510Z", "averageInterest": 48.7, "peakInterest": 100, "peakDate": "2026-05-17T00:00:00.000Z", "latestInterest": 3, "trendDirection": "falling", "topRelatedQuery": "google trends api documentation", "topRisingQuery": "meetglimpse google trends api", "topRegion": null }
{ "type": "related_query", "keyword": "google trends api", "listType": "top", "query": "google trends api documentation", "value": 100, "valueLabel": "100" }
{ "type": "related_query", "keyword": "google trends api", "listType": "rising", "query": "google trends api documentation", "value": 60, "valueLabel": "+60%" }
{ "type": "summary", "keyword": "google trends scraper", "comparisonGroup": ["google trends api", "google trends scraper", "google trends data"], "averageInterest": 1.1, "peakInterest": 2, "peakDate": "2025-11-09T00:00:00.000Z", "latestInterest": 0, "trendDirection": "falling", "topRelatedQuery": null, "topRisingQuery": null, "topRegion": null }

(The last row is from a 3-keyword comparison, so its values are on the shared scale. Shared fields shortened after the first row.)

โ“ FAQ

Q: Is this legal? A: This Actor calls a third-party data API, DataForSEO, which supplies Google Trends data from its own infrastructure. It returns aggregate, anonymous search-interest figures and no personal data. Your downstream use of the data is your responsibility - see the full Terms of Service and the Actor-Specific Addendum below for details.

Q: Are the numbers search volumes? A: No. Google Trends values are relative, from 0 to 100, where 100 is the peak for the chosen keyword, place and time range. They show interest over time and between places, not how many searches happened. For monthly search volumes, see unseenuser/keyword-search-volume.

Q: Why do my numbers differ slightly from the Google Trends website or between runs? A: Google Trends works from a sample of searches, so values can move by a few points between requests. This is normal and the same on the Google Trends website.

Q: What is the difference between a keyword report and a comparison? A: A keyword report puts one keyword on its own 0-100 scale and includes regions, related queries and related topics. A comparison puts 2 to 5 keywords on one shared scale, so you can see which is bigger, with interest over time and regions for each. Google Trends only shows related queries and topics for one keyword at a time.

Q: How is trendDirection worked out? A: It compares the average of the last quarter of the time range with the quarter before it (the latest partial period is ignored). More than 10% higher is rising, more than 10% lower is falling, anything else is stable.

Q: Do YouTube, News, Images and Shopping searches return everything? A: Interest over time is available for every search type. Regions, related queries and related topics are fullest for web search; other search types may return fewer data sets. The Actor outputs whatever Google Trends returns.

Q: Why did a keyword return NO_DATA? A: Google Trends only has data for terms with enough searches. Very rare terms, typos and very narrow time ranges or places often have none. You are not charged for it.

Q: Can I get data by city or a custom date range? A: Not in this version. You can pick worldwide or one country (with regions inside it) and one of the preset time ranges.

Q: Can I schedule it? A: Yes. Save your input as a task and schedule it weekly to track how interest moves.

Q: Can AI agents and MCP clients use it? A: Yes, through Apify's MCP server or the Apify API.

Q: Can I use this data to train AI? A: Check the terms of the data source and Google first, and see the Addendum. The Publisher does not grant AI-training rights.

Q: What if Google or the data provider sends a cease-and-desist? A: Notify UnseenUser within 48 hours via the Apify profile contact form (apify.com/UnseenUser) and cease using this Actor immediately.

Q: Is there an official Google Trends API? A: Google announced an official Google Trends API in July 2025 as an alpha that requires an early-access application; as of mid-2026 it was not generally available. Check Google's Search Central documentation for the current status. This Actor works as a Google Trends API you can call today: send keywords through the Apify API and get interest over time, regions, related queries and related topics back as JSON, CSV or Excel.

Q: Where is the Google Trends API documentation for this Actor? A: On this page: Inputs Overview with an example input, and Output Fields with real example rows. The API tab of this Actor shows ready-made calls for HTTP, JavaScript, Python, the CLI and MCP.

Q: How do I use the Google Trends API in Python? A: Install the Apify client (pip install apify-client) and run:

from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("unseenuser/google-trends-scraper").call(run_input={"keywords": ["google trends api"]})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
print(row.get("type"), row.get("date"), row.get("value"))

There is no pytrends install, no cookies and no rate-limit retries to handle on your side.

Q: How do I scrape Google Trends without getting blocked? A: Scripts and GitHub projects that load the Google Trends website get rate-limited or blocked once you send many keywords. This Actor does not load the website: it gets the data from a data API, so there are no captchas or blocked pages, and keywords run in parallel. Keywords with no data are free.

Q: How do I compare keywords in Google Trends? A: Put 2 to 5 keywords in Compare keywords. They come back on one shared 0-100 scale, as on the Google Trends website. In a real run comparing google trends api, google trends scraper and google trends data worldwide over 12 months, the average interest was 35.8, 1.1 and 59.5. A comparison is one charged event, however many keywords it has.

Q: Can I get YouTube search trends? A: Yes. Set Search type to YouTube to get interest over time for YouTube searches. News, Images and Google Shopping work the same way; see "Do YouTube, News, Images and Shopping searches return everything?" above for which data sets each one returns.

Q: How do I export Google Trends data to CSV or Excel? A: Run the Actor, open the dataset and download it as CSV, Excel or JSON, or pick a view such as Interest over time to download only those rows. Every row is flat, so it opens straight in Sheets or Excel.

Q: Is there a free plan limit? A: NOTE: Free Apify users receive up to 5 results per run. Upgrade to any paid Apify plan to remove this limit. This limit was set by the Actor developer, not by Apify.

Q: How do I compare more than 5 keywords? A: Google Trends puts at most 5 keywords on one scale, and so does this Actor. A common method for more is an anchor keyword: pick one keyword that appears in every group, run one comparison per group (the anchor plus up to 4 others, one comparison per run), then rescale each group so the anchor matches. For example, multiply every value in a group by the anchor's average in the first group divided by the anchor's average in that group. The Actor gives you the rows for each comparison; the rescaling is a step you do in a spreadsheet or script.

Q: Do I need a Google Trends API key? A: No. You do not need a Google API key or a Google account. To call this Actor from code you only need your Apify API token, which you find in Apify Console under Settings > Integrations.

Q: Is Google Trends data free? A: The Google Trends website is free to use in a browser. This Actor charges per keyword report or comparison, never per row (see Pricing), keywords with no data are free, and free Apify users can try it with up to 5 results per run.

Q: Can I see YouTube search trends worldwide or for one country? A: Yes. Set Search type to YouTube and Country to Worldwide or one of the listed countries. With a country, interest by region is broken down into its states or regions when Google Trends has that data.

๐ŸŽฌ Demo videos

Schedule this Actor to track Google Trends for your keywords every week:

Send the trend rows to Google Sheets, Slack, Make, Zapier or your own app:

๐Ÿ”ง How It Works

  • Live data: every run asks for fresh Google Trends data. Nothing is served from a stored copy.
  • No browser: the data comes from a data API, so there are no captchas, blocked pages or page-layout breakages.
  • Speed: a report is usually ready in under a minute; many keywords run at the same time.
  • Output: flat rows stream into an Apify dataset. Download them as JSON, CSV or Excel, or pull them via the Apify API.
  • Memory: the default 256 MB is enough.
  • Run summary: the run's key-value store holds RUN_SUMMARY: what happened to each keyword and comparison, rows by type and the events charged.
  • Live progress: while a run is active, its live view shows how many reports are done and how many are still waiting for data.

Apify Actor - Terms of Service

Version: 4.0 Effective Date: May 5, 2026


0. ACCEPTANCE BY USE - IMPORTANT

Read this section first.

These Terms of Service ("Terms") form a binding legal agreement between you ("User," "you," "your") and UnseenUser, the Publisher of this Apify actor ("UnseenUser," "the Publisher," "we," "us," "our").

0.1 How You Accept These Terms

You accept these Terms by any of the following actions, each of which constitutes a clear, affirmative act of acceptance:

  • (a) Running the Actor - Initiating any execution of the Actor on the Apify platform
  • (b) Using any output returned by the Actor for any purpose
  • (c) Continuing to access the Actor's listing or documentation after these Terms are visible

0.2 Continuing Acceptance

Each time you run the Actor or use its outputs, you reaffirm your acceptance of the then-current Terms. If you do not agree to these Terms or any subsequent update, you must stop using the Actor immediately.

0.3 No Anonymous Acceptance

You cannot disclaim acceptance by:

  • Failing to read these Terms before running the Actor
  • Running the Actor through automated systems
  • Sharing your Apify account with others who may not have read these Terms

By the act of running the Actor on Apify, you bind yourself, your organization (if applicable), and any individuals or systems acting on your behalf or under your authority.

0.4 If You Do Not Accept

If you do not agree to these Terms, you must not run the Actor. No use is authorized without acceptance.


PREAMBLE - UNDERSTANDING THE ARCHITECTURE

Before using the Actor, please understand the technical architecture of the service:

The Data Flow

You (User) โ†’ Apify Platform โ†’ Actor (software) โ†’ Third-Party API โ†’ Source Platform
โ†“
You (User) โ† Apify Platform โ† Actor (software) โ† Third-Party API

What Each Party Does

  • You (the User): Run the Actor on the Apify platform with input parameters you choose
  • Apify: Operates the cloud infrastructure that hosts and executes Actors. Apify is a Czech-incorporated company (Apify Technologies s.r.o.) governed by its own Terms of Service.
  • The Publisher (us): Publishes software code (the Actor) on Apify's platform. The Actor is a thin wrapper that translates your input into requests to a third-party API and returns the API's responses to you. The Publisher does not operate scraping infrastructure. The Publisher does not store or retain data returned by the Actor. The Publisher does not see, log, or process the personal data of any individuals returned in the Actor's outputs beyond what is incidental to passing the data through.
  • Third-Party API Provider: DataForSEO (https://dataforseo.com). This is an independent third-party company that operates data infrastructure and databases that provide search-market estimates and returns them.
  • Source Platform: Google (Google Trends search-interest data), via DataForSEO's own infrastructure. This is the platform whose data is provided by the Third-Party API Provider.

Why This Matters

Your relationship with the Publisher is that of a software user to a software vendor. The Publisher has the responsibilities of a software vendor (functional code, accurate documentation) and the limits of one (the Publisher is not responsible for how you use the data you obtain).


These Terms operate alongside but do not replace:

  • Apify's Terms of Service and Acceptable Use Policy (governing your relationship with Apify)
  • DataForSEO Terms of Service (governing the underlying data infrastructure)
  • Source Platform terms (Google, for Google Trends data) governing the data provided
  • Applicable law in your jurisdiction and the jurisdictions of data subjects

These Terms incorporate the actor-specific addendum published in each Actor's individual listing ("Addendum"). In the event of a conflict, the more restrictive provision applies.


1. NATURE OF THE SERVICE

1.1 What the Actor Is

The Actor is a software program published on the Apify platform. Each Actor:

  • (a) Accepts structured input from you on the Apify platform
  • (b) Translates that input into HTTP requests to a third-party API operated by DataForSEO
  • (c) Receives HTTP responses from that third-party API
  • (d) Returns the response data to you in a structured format on the Apify platform

The Actor's source code is hosted on Apify's infrastructure. The Actor runs in Apify's cloud, not on the Publisher's servers. The Publisher operates no servers running the Actor.

1.2 What the Actor Is Not

The Actor is not:

  • (a) A scraping tool - the Publisher does not operate scraping infrastructure, proxies, headless browsers, or fake accounts
  • (b) A direct connection to any source platform - connections to the source platform are made by DataForSEO
  • (c) A data storage or data retention service - the Publisher does not maintain a database of any data the Actor returns
  • (d) A licensed access channel to Google (Google Trends data), via DataForSEO's own infrastructure, or any other source platform
  • (e) Affiliated with, endorsed by, sponsored by, or authorized by any source platform

1.3 The Publisher's Limited Role

The Publisher's role is limited to:

  • (a) Designing and writing the Actor's source code
  • (b) Publishing the Actor on the Apify Store
  • (c) Maintaining the Actor (updating it when API providers change schemas)
  • (d) Providing documentation and customer support via Apify's contact mechanism

The Publisher is a software vendor, similar to a developer who publishes an app on the Apple App Store or Google Play Store. The Publisher is not a data provider, data broker, data processor, or data controller for purposes of GDPR, CCPA, Israel's Privacy Protection Law, or equivalent.

1.4 The Third-Party API Provider's Role

DataForSEO (https://dataforseo.com) is an independent third-party company. It:

  • (a) Operates the actual data infrastructure and databases
  • (b) Maintains relationships with the Source Platform (or accepts the operational risk of accessing public data without such relationships)
  • (c) Provides its own Terms of Service governing its operations
  • (d) Is responsible for compliance obligations relating to the data collection itself

The Publisher is a customer of this provider. The Publisher is not its agent, partner, or representative.


2. WHO MAY USE THE ACTOR

2.1 Eligibility

You may use the Actor only if:

  • (a) You are at least 18 years old or the age of majority in your jurisdiction
  • (b) You have legal capacity to enter into binding contracts
  • (c) You are not located in or resident of a country subject to comprehensive sanctions by the United States, European Union, United Kingdom, or Israel
  • (d) You are not on any prohibited persons list

2.2 User Representations

By using any Actor, you represent and warrant that:

  • (a) Truthful identity: Information you provide about your identity and intended use is accurate
  • (b) Lawful intent: Your intended use complies with applicable law in your jurisdiction
  • (c) Source platform compliance: You will independently comply with the Terms of Service of any source platform whose data you obtain through the Actor
  • (d) Data subject rights: Where Actor outputs include personal data, you will respect data subject rights under applicable law
  • (e) No prohibited use: You will not use the Actor for any of the purposes prohibited in Section 4

These representations are continuous - they must remain true throughout your use.


3. PERMITTED USES

The Actor may be used for any lawful purpose, including:

  • Market research and competitive analysis
  • Academic research
  • Journalism and investigative reporting
  • Internal business intelligence
  • Brand monitoring
  • Recruitment research where consistent with applicable employment law
  • Building products that further process publicly available information lawfully

Specific permitted uses for each Actor are described in that Actor's individual listing and Addendum.


4. PROHIBITED USES

You may not use the Actor for any of the following:

4.1 Illegal Activity

Activity illegal under the law of your jurisdiction, the User's jurisdiction, or the jurisdiction of any data subjects.

4.2 Harassment, Stalking, and Personal Targeting

  • Compiling profiles for harassment, stalking, or doxxing
  • Tracking individuals' movements or activities without their knowledge
  • Building profiles of journalists, activists, dissidents, or vulnerable populations for retaliatory purposes

4.3 Discrimination

  • Using outputs for discriminatory employment, lending, housing, or insurance decisions based on protected characteristics
  • Building lists for discriminatory purposes

4.4 Spam and Unsolicited Commercial Communication

  • Sending unsolicited marketing in violation of CAN-SPAM, CASL, GDPR, PECR, Israeli Anti-Spam Law (ืกืขื™ืฃ 30ื ืœื—ื•ืง ื”ืชืงืฉื•ืจืช), or equivalent laws
  • Building "lead lists" from scraped contacts without proper consent infrastructure
  • Reselling contact data for spam purposes

4.5 Fraud and Deception

  • Identity theft or impersonation
  • Generation of fake reviews, testimonials, or coordinated inauthentic behavior
  • Election interference or political disinformation
  • Securities fraud

4.6 Source Platform Abuse

  • Using outputs to circumvent technical protection measures of source platforms
  • Creating fake accounts on source platforms based on Actor outputs
  • Vote manipulation, engagement manipulation, or platform algorithm gaming
  • Building services that competitively substitute for source platforms

4.7 Reselling the Actor's Service

  • Reselling raw Actor outputs as your own data product or scraping-as-a-service
  • Sharing your Apify credentials to provide third parties indirect access
  • Building competing API services using Actor outputs

4.8 AI Training Without Authorization

  • Using Actor outputs as training data for commercial AI/ML models without separate licensing authority from the source platform

4.9 Sensitive Targeting

  • Specifically targeting or profiling based on health conditions, sexual orientation, religious beliefs, political opinions, or other sensitive characteristics
  • Targeting children under 16 (or local age of consent for data processing)

4.10 Privacy Law Violations

  • Processing personal data of EU/UK/California/Israeli residents without complying with applicable privacy law
  • Failing to honor data subject access, deletion, or objection requests
  • Processing data for purposes incompatible with its publication context

5. SOURCE PLATFORM TERMS - YOUR RESPONSIBILITY

5.1 Acknowledgment

The Actor accesses data from a third-party platform ("Source Platform") through the Third-Party API Provider (DataForSEO). The Source Platform is Google (Google Trends search-interest data), via DataForSEO's own infrastructure.

5.2 Your Sole Responsibility

You acknowledge:

  • (a) You are solely responsible for ensuring your downstream use of data obtained through the Actor complies with the Source Platform's Terms of Service
  • (b) The Publisher makes no representation that any specific use is permitted under any Source Platform's terms
  • (c) The Third-Party API Provider, not the Publisher, bears responsibility for the lawfulness of the data collection itself
  • (d) You should review Source Platform terms before commercial use:

5.3 Cease-and-Desist Compliance

If you receive a cease-and-desist letter or other legal demand from a Source Platform regarding your use of Actor outputs, you must:

  • (a) Cease the contested use immediately
  • (b) Notify UnseenUser within 48 hours via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser)
  • (c) Cooperate with the Publisher as needed to mitigate
  • (d) Not assert against the Publisher any claim arising from your inability to use the Actor for that Source Platform

6. DATA PROTECTION - REFLECTING ACTUAL ARCHITECTURE

6.1 Roles Under Privacy Law

For purposes of GDPR, UK GDPR, CCPA, Israel's Privacy Protection Law (PPL) including Amendment 13, and equivalents:

  • You (the User) are the Data Controller of any personal data you obtain through the Actor and subsequently process for your own purposes
  • DataForSEO is the entity that collects and provides data from the Source Platform - it bears the responsibilities of a data processor or controller (depending on context) for the collection itself
  • The Publisher acts solely as a software vendor, not as a data controller or processor, because the Publisher does not store, retain, or substantively process personal data - the Actor merely passes API responses through

6.2 No Data Retention by the Publisher

The Publisher confirms:

  • (a) The Publisher does not maintain a database of personal data obtained through the Actor
  • (b) The Actor passes data from the Third-Party API directly to you on the Apify platform - data does not flow through the Publisher's infrastructure
  • (c) Apify's standard execution and operational logging may include limited information about Actor runs (input parameters, run duration, data volume) - this is governed by Apify's own privacy practices
  • (d) The Publisher does not access, view, or analyze your Actor outputs except as needed for technical support if you specifically share them with the Publisher

6.3 Your Obligations as Data Controller

Where your use of the Actor involves processing personal data, you are responsible for:

  • (a) Establishing a lawful basis for your processing (consent, legitimate interest with documented balancing test, contract, etc.)
  • (b) Providing transparent notice to data subjects as required by applicable law
  • (c) Honoring data subject access, rectification, erasure, restriction, and portability requests
  • (d) Implementing appropriate security measures
  • (e) Conducting Data Protection Impact Assessments where required
  • (f) Appointing a Data Protection Officer if your operations require one
  • (g) Registering databases with applicable supervisory authorities
  • (h) Honoring opt-out requests for direct marketing
  • (i) Cross-border transfer safeguards where data crosses borders

6.4 Israel's Amendment 13 - User Compliance

If your use of the Actor involves Israeli residents' personal data, you must comply with the Privacy Protection Law as amended (Amendment 13, effective August 14, 2025). These obligations are yours as the data controller, not the Publisher's as the software vendor.

6.5 Sensitive Data Targeting Restrictions

You will not use the Actor to specifically target, profile, or build datasets focused on:

  • Health or medical conditions
  • Religious beliefs
  • Political opinions
  • Sexual orientation or gender identity
  • Genetic or biometric data
  • Criminal history
  • Children under 16

7. INTELLECTUAL PROPERTY

7.1 Actor Code

The Actor's source code, schemas, documentation, and branding are owned by the Publisher. You receive a limited, non-exclusive, non-transferable, revocable license to use the Actor for permitted purposes during your active subscription/run with Apify.

7.2 Output Data

The Publisher claims no ownership over the public data the Actor returns. Source Platforms may have copyright, database rights, or other rights in their data; data subjects may have copyright in user-generated content. Your use of output data must respect these rights independently.

7.3 Restrictions

You may not reverse engineer, decompile, or reuse the Actor's code in a competing actor.

7.4 Feedback

Feedback you provide may be used by the Publisher to improve products without compensation to you.


8. PRICING AND PAYMENT

8.1 Apify Platform Billing

Pricing is administered through Apify's pricing models. Apify processes all payments. Apify's payment terms govern refunds and disputes.

8.2 Pricing Changes

The Publisher may change Actor pricing with at least 14 days' notice via the Actor's Apify listing.

8.3 No Refunds for Misuse

If your access is suspended or terminated for breach of these Terms, you forfeit any unused balance and are not entitled to refunds.


9. SERVICE AVAILABILITY AND CHANGES

9.1 No Uptime Guarantee

The Actor depends on:

  • (a) The Apify platform
  • (b) Underlying API provider (DataForSEO)
  • (c) The Source Platform's continued availability

Any of these may change behavior, restrict access, or become unavailable without notice. The Publisher makes no uptime guarantees.

9.2 Service Discontinuation

The Publisher may discontinue any Actor at any time. Reasonable notice will be provided when feasible.


10. DISCLAIMERS

10.1 "AS IS" Service

THE ACTOR IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR PURPOSE, NON-INFRINGEMENT, OR ACCURACY OF DATA.

10.2 No Representation of Lawfulness

The Publisher makes no representation that your specific use of the Actor or the data it returns is lawful in your jurisdiction or under any Source Platform's terms. The burden of determining lawfulness for your use case is yours.

10.3 No Endorsement of Source Content

Content returned by the Actor was created by third parties. The Publisher does not endorse, verify, or take responsibility for it.


11. LIMITATION OF LIABILITY

11.1 Aggregate Liability Cap

TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE AGGREGATE LIABILITY OF THE PUBLISHER FOR ALL CLAIMS RELATING TO THE ACTOR EXCEED THE GREATER OF:

  • (a) ONE HUNDRED U.S. DOLLARS (US $100), OR
  • (b) THE AMOUNTS YOU PAID THROUGH APIFY FOR USE OF THE ACTOR IN THE THREE (3) MONTHS IMMEDIATELY PRECEDING THE EVENT

11.2 Excluded Damages

THE PUBLISHER IS NOT LIABLE FOR INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR LOSS OF PROFITS, REVENUE, OR DATA, EVEN IF ADVISED OF THE POSSIBILITY.

11.3 Time Limit

Any claim must be brought within one (1) year of the event.


12. INDEMNIFICATION

12.1 Your Indemnification of the Publisher

You agree to defend, indemnify, and hold harmless the Publisher from any:

  • Claims arising from your use of the Actor
  • Claims arising from your violation of these Terms
  • Claims arising from your violation of any law (including privacy law)
  • Claims arising from your violation of any Source Platform's Terms of Service
  • Claims arising from your processing of personal data obtained through the Actor
  • Reasonable attorneys' fees and costs of defending such claims

12.2 Defense

The Publisher may assume defense at your expense. You will cooperate with the Publisher's defense.

12.3 Scope

The indemnification covers reasonable, foreseeable third-party claims arising from your use. It does not extend to:

  • Claims arising from the Publisher's gross negligence or willful misconduct
  • Claims regarding the Actor's source code itself (those are the Publisher's responsibility)
  • Claims regarding the Third-Party API Provider's data collection (that is its responsibility)

13. SUSPENSION AND TERMINATION

13.1 Termination by the Publisher

The Publisher may terminate your access for material breach, illegal use, breach of warranty, or upon credible legal demand.

13.2 Effects of Termination

Your license ends, you must cease use, and applicable provisions survive.

13.3 Termination by You

You may stop using the Actor at any time on Apify.


14. DISPUTE RESOLUTION

14.1 Informal Resolution First

Send a detailed written description of the dispute via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) and wait 60 days for resolution attempt before any formal claim.

14.2 Governing Law

These Terms are governed by the substantive laws of the State of Israel, without regard to conflict of law principles.

14.3 Exclusive Jurisdiction

Any dispute shall be brought exclusively in the competent civil courts of Tel Aviv-Jaffa, Israel.

14.4 No Class Actions

You agree to bring claims only in your individual capacity.

14.5 Attorneys' Fees

The prevailing party recovers reasonable attorneys' fees.


15. MISCELLANEOUS

15.1 Entire Agreement

These Terms (with Addendum and incorporated documents) are the entire agreement.

15.2 Severability

Unenforceable provisions are reformed to the minimum extent or severed.

15.3 Assignment

You may not assign without the Publisher's consent. The Publisher may assign to affiliates, successors, or acquirers.

15.4 Force Majeure

Neither party is liable for failure due to events beyond reasonable control, including changes by the Source Platform or the Third-Party API Provider, or actions by Apify.

15.5 Third-Party Beneficiaries

Apify and DataForSEO are intended third-party beneficiaries of Sections 4 (Prohibited Uses), 5 (Source Platform Compliance), and 12 (Indemnification).

15.6 Survival

Sections 0 (Acceptance), 4, 5, 6, 7, 10, 11, 12, 14, and 15 survive termination.

15.7 Language

English controls. Translations are for convenience only.

The Publisher operates on the Apify platform under the username UnseenUser (apify.com/UnseenUser). The Publisher is a registered legal entity. Upon receipt of valid legal process (subpoena, court order, or equivalent) directed through Apify's official channels, the Publisher's full legal identity may be disclosed as required by law. This Section ensures that you have a valid path to legal recourse if needed.


16. ACKNOWLEDGMENT

By using any Actor, you acknowledge that:

  • (a) You have read these Terms
  • (b) You understand the architecture: you are using software (the Actor) on Apify's platform that calls third-party APIs
  • (c) You accept responsibility for your use, including for compliance with Source Platform terms
  • (d) Your indemnification obligations cover third-party claims arising from your use
  • (e) Disputes are resolved in Israeli courts
  • (f) The Publisher's identity, while not publicly disclosed in this listing, can be obtained through valid legal process via Apify

For questions, use UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) before running the Actor.


APPENDIX - Document Version History

VersionDateSummary
1.0May 5, 2026Initial publication
2.0May 5, 2026Hardened (over-broad - treated User as data broker)
3.0May 5, 2026Architecturally accurate - Publisher as software vendor
4.0May 5, 2026Anonymous Publisher. All personally identifying information removed. Acceptance-by-Use mechanism formalized.

These Terms reflect best practices for anonymous Apify actor publishing as of May 2026. Not a substitute for legal advice.


๐Ÿ›ก๏ธ Part 4: Actor-Specific Terms of Service Addendum

This addendum supplements the Master Terms of Service V4.0. By running this Actor, you accept both the Master ToS and this addendum.

A. Architectural Disclosure

This Actor is a software wrapper. It accepts your input parameters, creates tasks on the DataForSEO Google Trends Explore endpoint (/keywords_data/google_trends/explore/task_post) and collects the finished results (/keywords_data/google_trends/explore/task_get), reshapes them into flat rows and summary rows, and returns the data to you on the Apify platform. UnseenUser does not store, log, or substantively process the data returned. The data flows from DataForSEO through Apify's runtime directly to you. No results are cached between runs.

B. Nature of Data Returned

This Actor returns aggregate Google Trends search-interest data as provided by the data provider named in Section A: relative interest over time (0-100), relative interest by country or region, related topics and related queries (top and rising), and a Google Trends link per keyword. It adds computed summary fields (average, peak, latest value, trend direction, top related query, top rising query, top region). It does not return names, profiles, contact details or any content authored by individuals.

Where the Actor's output includes individual people's names, photos, contact details, or content authored by them, that data constitutes personal data subject to GDPR, CCPA, Israeli Privacy Protection Law (including Amendment 13), and equivalent privacy laws in your downstream processing - but only in your hands as the data controller, not in UnseenUser's hands as the software vendor. For this Actor, such data is not expected in normal output; if a keyword or a related query contains a person's name (for example searches for a named individual), treat that row with the same care.

C. Permitted Use Cases

You may use this Actor for the following purposes (non-exhaustive list):

  • Content and SEO planning - find rising topics and related queries
  • Seasonality analysis - time launches, stock and campaigns around peaks
  • Product and brand comparison - compare up to 5 terms on one scale
  • Market entry research - compare interest across countries and regions
  • Reporting and dashboards - feed trend data into your own reports and tools
  • Academic and journalistic research - study public interest in topics over time

D. Specifically Prohibited Uses

In addition to Master ToS Section 4 prohibitions, you may NOT:

  • Resell raw output as a Google Trends dataset or a public "Google Trends API" (Master ToS 4.7)
  • Use the data to compete with or adversely affect Google's business interests, including building a substitute for Google Trends as a product (the data provider's terms, Section 7.1)
  • Present Google Trends values (relative 0-100 interest) as absolute search volumes, audited figures or guaranteed traffic
  • Use trend data on health, religion, sexual orientation, political or other sensitive topics to profile or target individuals (Master ToS 4.9, 6.5)
  • Use related queries that name individuals to monitor, profile or harass those individuals
  • Share your Apify credentials or run outputs as a service so third parties get indirect access to the Actor

E. Platform Terms of Service Considerations

The data originates from Google Trends and is provided by the data provider named in Section A from its own infrastructure. Google's Terms of Service govern Google's services; the data provider's terms of service govern the data you receive through it, and Section 7.1 of the data provider's terms states that search engine data must not be used to compete with or adversely affect the search engine providers it comes from. The data provider bears responsibility for the lawfulness of its own data collection. Your downstream use must independently comply with Google's terms and the data provider's terms. If you publish charts or figures, attribute them to Google Trends.

If Google or the data provider named in Section A issues a cease-and-desist regarding data obtained via this Actor, notify UnseenUser within 48 hours via the Apify profile contact form (apify.com/UnseenUser) and cease your use immediately.

F. Data Sensitivity

  • Interest over time and by region: low sensitivity (aggregate, anonymous, relative figures)
  • Related queries and topics: low sensitivity, but they are generated by Google from real searches and can occasionally contain names, offensive terms or sensitive subjects. Review them before publishing.
  • Your keywords are sent to the data provider. Do not put confidential information (unreleased product names, client names, personal data) into keywords.

G. Relative Values, Sampling and Accuracy

  • Relative, not absolute. Every value is 0-100 relative to the peak within the chosen keyword(s), place, search type and time range. Values from different runs, places or time ranges are not on the same scale unless they were compared in one comparison.
  • Sampling. Google Trends works from a sample of searches; values can move by a few points between requests.
  • Low volume. Terms with too few searches return no data (NO_DATA), and regions with too little data are left out.
  • Partial periods. The latest period is often incomplete and is flagged isPartial.
  • Computed fields. averageInterest, peakInterest, peakDate, latestInterest, trendDirection and the top... fields are calculated by the Actor from the returned data using the rules in the README. They inherit every limitation above.
  • Machine-generated lists. Related queries and topics are produced by Google's systems; this Actor does not edit or filter them.

Do not use these figures as the sole basis for financial commitments, contractual guarantees, or legal claims.

H. Cost Disclosure and Charging Rules

This Actor charges a $0.02 start fee per run plus $0.012 per keyword report and $0.012 per comparison that returned data.

Never charged:

  • Keywords with no data (NO_DATA)
  • Invalid keywords (never sent)
  • Keywords whose data was not ready in time (NOT_READY)
  • Error and information rows
  • Rows themselves: a report is charged once however many rows it contains

When the run reaches your "Maximum cost per run", the Actor stops creating new reports and finishes cleanly with a MAX_CHARGE_REACHED row.

I. Redistribution and Competitive Use

UseStatus
Use trends in your own content, SEO, product or marketing planningโœ… Permitted
Include charts and figures in reports for your clients, attributed to Google Trendsโœ… Permitted
Show trend data inside your own product as part of a larger featureโœ… Generally permitted; check the data provider's terms (Section A) for your specific product
Sell bulk exports of Google Trends data as a datasetโŒ Prohibited - reselling raw output (Master ToS 4.7)
Offer a public "Google Trends API" or "Google Trends replacement" built on this outputโŒ Prohibited - competing service (Master ToS 4.6, 4.7; the data provider's terms, Section 7.1)
Train a commercial AI model on large volumes of this outputโŒ Prohibited without separate licensing (Master ToS 4.8)

J. Sensitive Topics and Elections

  • Researching public interest in health, legal, religious, sexual or political topics is lawful research; using the results to target or profile individuals is prohibited (Master ToS 4.9 and 6.5).
  • Trend data about candidates, parties or elections must not be presented as polling or voting intention.
  • Political advertising based on this data must comply with election and political advertising laws in the target country.

K. Cease-and-Desist Protocol

If Google, the data provider named in Section A, or a regulator contacts UnseenUser regarding your use:

  • UnseenUser will notify Apify per Master ToS Section 8
  • UnseenUser may suspend access to this Actor pending investigation
  • You agree to provide documentation of your use upon reasonable request

If you receive a demand from Google or the data provider named in Section A regarding data obtained through this Actor:

  • Cease the contested use immediately
  • Notify UnseenUser within 48 hours via the Apify profile contact form (apify.com/UnseenUser)
  • Document the demand and your response

L. Free-Plan Limit

NOTE: Free Apify users receive up to 5 results per run. Upgrade to any paid Apify plan to remove this limit. This limit was set by the Actor developer, not by Apify.