Google Trends API
Python client for Google Trends data via the Trends API. Normalized 0-100 scores, history + growth, free tier. Not a scraper.
Key: trendsapi.ai/#get-key. Full contract: trendsapi-ai/trendsapi.
JS: google-trends-js, google-trends-node, google-trends-client.
Install
pip install google-trends-client
from google_trends_client import TrendsAPI
client = TrendsAPI() # TRENDSAPI_KEY
series = client.get_time_series("heat pump")
growth = client.get_growth("heat pump", percent_growth=["12M"])
hot = client.get_live(limit=10)
Keyword helpers default to source: "google search". Override source= for any other platform. Official full client: trendsapi.
Call
| Field | Value |
|---|---|
| Endpoint | POST https://api.trendsapi.ai/api |
| Auth | Authorization: Bearer $TRENDSAPI_KEY |
| History | source: google search with get_time_series or get_growth |
| Keyword | Any phrase, e.g. heat pump |
Live type |
Google Trends |
curl -sS -X POST https://api.trendsapi.ai/api \
-H "Authorization: Bearer $TRENDSAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"mode":"get_time_series","source":"google search","keyword":"heat pump"}'
Related sources (same endpoint, different source): google images, google news, google shopping.
value is 0-100 for this term on Google web search, not Ads impressions.
Site: https://trendsapi.ai/trends/google-trends. GitHub: trendsapi-ai/google-trends-api.
License
MIT. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file google_trends_client-1.0.1.tar.gz.
File metadata
- Download URL: google_trends_client-1.0.1.tar.gz
- Upload date:
- Size: 3.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
01b94f6c2641ae92994efd9104b2d5650c09a6a00fb87c5b94ed87a9207438ab
|
|
| MD5 |
d9fe38d964f1fe3ed3cdd0064d495e60
|
|
| BLAKE2b-256 |
0db67d2da49f5acb39b6d50712ee4fa5d46bb906395c713e6a8e97f77fd63120
|
File details
Details for the file google_trends_client-1.0.1-py3-none-any.whl.
File metadata
- Download URL: google_trends_client-1.0.1-py3-none-any.whl
- Upload date:
- Size: 3.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f22779f243fda6e54996cb7588ab3b9c087b8f5b1be66cfcc89c80b6f423d97b
|
|
| MD5 |
67bb887c24073bbda3dd4cf300bfca99
|
|
| BLAKE2b-256 |
9fb23af289fdc1fc1cb49589f5c0ee229487702f8d58b7832a15c8b128d0967d
|
