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
2 maintainers
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.4.tar.gz
(5.3 kB
view details)
File details
Details for the file pytrends-1.0.4.tar.gz.
File metadata
- Download URL: pytrends-1.0.4.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d8f628802518fca7151ecb4456ec02ac45116d2495a03e489125c86b4b15f70c
|
|
| MD5 |
8df37b14d85e158a280d48e446835ed2
|
|
| BLAKE2b-256 |
b1ad445949913763e7eaab5732c6dcc5438a4587e6ea31f2507e4ff6559930f0
|
