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
Release files for pytrends 1.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pytrends-1.0.4.tar.gz | 5.3 kB | Details |
Release files / pytrends-1.0.4.tar.gz
| Download URL | pytrends-1.0.4.tar.gz |
|---|---|
| Size | 5.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d8f628802518fca7151ecb4456ec02ac45116d2495a03e489125c86b4b15f70c
|
|
BLAKE2b-256 checksum How to use checksums |
b1ad445949913763e7eaab5732c6dcc5438a4587e6ea31f2507e4ff6559930f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
