Skip to main content

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

Project details


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)

Uploaded Source

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

Hashes for pytrends-1.0.4.tar.gz
Algorithm Hash digest
SHA256 d8f628802518fca7151ecb4456ec02ac45116d2495a03e489125c86b4b15f70c
MD5 8df37b14d85e158a280d48e446835ed2
BLAKE2b-256 b1ad445949913763e7eaab5732c6dcc5438a4587e6ea31f2507e4ff6559930f0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page