Pseudo API for Google Trends
Project description
pytrends
=========
### About
**Pseudo API for Google Trends**
* Allows simple interface for automating downloads of csv reports from Google Trends.
* Main feature is to help trick google into thinking the script is actually a browser.
* Only good until Google changes their backend again :-P
**Requirements**
* Written for both Python 2.7+ and Python 3.3+
* Requires a google account to use.
## Connect to Google
**pyGTrends(google_username, google_password)**
**Parameters**
* google_username
- a valid gmail address
* google_password
- password for the gmail account
### Request a Report
**request_report(keywords, hl='en-US', cat=None, geo=None, date=None, use_topic=False)**
**Parameters**
* keywords
- the words to get data for
- Example "Pizza"
- Alternately: "Pizza + Italian"
- Alternately: "iron - chemical element" topic name is "%2Fm%2F025rw19" and needs use_topics=True
* hl
- language
- find available parameters by inspecting the url when manually using Google Trends
- defaults to US english
* cat
- category
- find available parameters by inspecting the url when manually using Google Trends
- defaults to none
* geo
- geographical area
- find available parameters by inspecting the url when manually using Google Trends
- defaults to world
* date
- date to start from
- defaults to all available data
- "MM/YYYY #m" where # is the number of months from that date to pull data for
- "10/2009 61m" would get data from October 2009 to October 2014
* use_topic
- set to true to avoid URLencoding the keywords
### Save a Report to file
**save_csv(path, trend_name)**
**Parameters**
* path
- output path
* trend_name
- human readable name for file
### Credits
* Connecting to google code heavily based off Sal Uryasev's pyGTrends
* With some ideas pulled from Matt Reid's Google Trends API
- https://bitbucket.org/mattreid9956/google-trend-api/overview
=========
### About
**Pseudo API for Google Trends**
* Allows simple interface for automating downloads of csv reports from Google Trends.
* Main feature is to help trick google into thinking the script is actually a browser.
* Only good until Google changes their backend again :-P
**Requirements**
* Written for both Python 2.7+ and Python 3.3+
* Requires a google account to use.
## Connect to Google
**pyGTrends(google_username, google_password)**
**Parameters**
* google_username
- a valid gmail address
* google_password
- password for the gmail account
### Request a Report
**request_report(keywords, hl='en-US', cat=None, geo=None, date=None, use_topic=False)**
**Parameters**
* keywords
- the words to get data for
- Example "Pizza"
- Alternately: "Pizza + Italian"
- Alternately: "iron - chemical element" topic name is "%2Fm%2F025rw19" and needs use_topics=True
* hl
- language
- find available parameters by inspecting the url when manually using Google Trends
- defaults to US english
* cat
- category
- find available parameters by inspecting the url when manually using Google Trends
- defaults to none
* geo
- geographical area
- find available parameters by inspecting the url when manually using Google Trends
- defaults to world
* date
- date to start from
- defaults to all available data
- "MM/YYYY #m" where # is the number of months from that date to pull data for
- "10/2009 61m" would get data from October 2009 to October 2014
* use_topic
- set to true to avoid URLencoding the keywords
### Save a Report to file
**save_csv(path, trend_name)**
**Parameters**
* path
- output path
* trend_name
- human readable name for file
### Credits
* Connecting to google code heavily based off Sal Uryasev's pyGTrends
* With some ideas pulled from Matt Reid's Google Trends API
- https://bitbucket.org/mattreid9956/google-trend-api/overview
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pytrends-1.0.3.tar.gz
(5.0 kB
view hashes)