Metadata-Version: 1.1
Name: pytrends
Version: 1.0.4
Summary: Pseudo API for Google Trends
Home-page: https://github.com/dreyco676/pytrends
Author: ['John Hogue', 'Burton DeWilde']
Author-email: dreyco676@gmail.com
License: MIT
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
        
Keywords: google trends api search
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: License :: OSI Approved :: MIT License
