Private package for pulling and merging Google Trends data
Pull and merge data from the Google Trends for Health API
This code has no license. Theodore L Caputi (Copyright 2020) retains all rights over all code in this package. Unauthorized use, including reuse, modification, and distribution, is forbidden.
The main function of the package is
theo_timeline, a function that pulls and merges data from the Google Trends API and saves a single CSV file for each term (dates on the index and geographies as the columns). Note that multiple files will be created if multiple timeframes are requested. An example script would be:
from gtrendspy import timeline timeline.theo_timeline( terms = ['cat', 'cat + food'], names = ['cat', 'food'], start = '2018-01-01', end = '2020-02-01', timeframe_list = ['month'], geo_country_list = ['US', 'CA'], worldwide = False, timestep_years = 1, batch_size = 2, us_states = False, outpath = "/path/to/output/directory", creds = "/path/to/info.txt" )
This script would pull monthly data for the search terms
cat + food for both the US and Canada between 1 Jan 2018 and 1 Feb 2020, and then reformat that data into two CSV files (
food_month.csv, respectively). Each of these CSV files would be formatted such that the first column (timestamp) gives the month and the second and third columns (US and CA) give search queries for the US and Canada, respectively.
This package is intended to be used in conjunction with the gtrendR package for R.
Note: This package assumes use of Python 3.X and pip3. It works on Linux and Windows OS.
Install from pip
(1) pip install from Github
pip install gtrendspy
(2) pip install requirements.txt
pip install -r requirements.txt
(3) Create a
creds file setting your own parameters (DISCOVERY_URL, API_KEY)
Your creds file should look something like this. You'll have access to both once Google approves your request for an API Key.
DISCOVERY_URL = "XXX" API_KEY = "XXX"
(4) Begin using the package! The merged output will be in the directory you named as
(1) Request tarball (gtrends.tar.gz) from firstname.lastname@example.org
(2) Run the command:
pip install --upgrade /path/to/gtrends.tar.gz
(3) Install dependencies using the command:
pip install -r /path/to/gtrends/requirements.txt
(4) Create a
creds file setting your own parameters (see above)
(5) Begin using the package! The merged output will be in the directory you named as
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.