Google Trends API
Google Trends shows how search interest in a term changes over time. interest_over_time compares up to 5 keywords and returns one row per point in time with a 0 to 100 interest value for each keyword.
Values are relative: 100 is the highest point for any keyword in the query, so results change when you add or remove a keyword. Low-volume terms show as 0. Points are weekly for a year, daily for 30 or 90 days, and hourly or by minutes for a day or a week; time gives the exact start. The last point is often still being counted (partial).
Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each Google Trends action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Search interest over timeinterest_over_time | Compare Google search interest for 1 to 5 keywords over time. | $8.81 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each Google Trends action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and features of the official site are not part of the EveryInfra API unless this page lists them.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
interest_over_timeSearch interest over time Compare Google search interest for 1 to 5 | keywords | country, language, search_type, time_window | Sync delivery | — | $8.81 per 1,000 requests | time · date_from · date_to · values · period_averages · partial · platform |
What do the Google Trends interest_over_time parameters mean?
Compare Google search interest for 1 to 5 keywords over time. Each row is one point in time with a 0 to 100 value per keyword, relative to the highest point in the query. Choose country, time_window from a day to five years, and search_type such as news or YouTube. Values are relative interest, not search counts.
keywordsRequired- A list of 1 to 5 search terms to compare, such as
["openai", "anthropic"]. Each term is at most 80 characters and 10 words.Google Trends Help: FAQ About Google Trends Data — Google Trends Help explains that the data comes from a sample of real searches, that each point is divided by total searches for its place and period and scaled from 0 to 100, and that low-volume terms appear as 0. The source supports the meaning of `values`; this API's `country`, `time_window` and `search_type` filters are defined by EveryInfra, and the source does not vouch for results. · Checked countryOptional- A two-letter country code such as
us,gborjpfor where to measure interest. Leave it out for worldwide. languageOptional- A two-letter language code such as
enorja. Usually not needed. search_typeOptional- Which Google search to measure:
web(default),news,youtube,imagesorshopping. time_windowOptional- The period to cover:
day,week,month(30 days),quarter(90 days),year(12 months, the default) orfive_years.
How to use the Google Trends API
- 01Choose a platform action from the public catalog.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Read the result from the response. For an asynchronous action, poll the returned job ID.
- 04Store the response fields that your application needs.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_trends","action":"interest_over_time","params":{"keywords":"<keywords>"}}'
Google Trends API questions
What can I retrieve with the Google Trends API?
Set platform to google_trends. The current catalog lists search interest over time. These action names identify different Google Trends objects or views; they are not interchangeable search modes.
Which input starts the Google Trends interest_over_time request?
A list of 1 to 5 search terms to compare, such as ["openai", "anthropic"]. Each term is at most 80 characters and 10 words. Send it as keywords inside params.
Which fields can Google Trends interest_over_time return?
Its declared schema includes time, date_from, date_to, and values. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every Google Trends action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.