Skip to content
Python script to download files via Google search.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
xgoogle @ 9889bd8


Python script to download files via Google search.


In order to use the script you need to install Python 3.x and the following packages:

  • setuptools

    For example:

      pip install setuptools
  • xgoogle (included as a git submodule in xgoogle/)

    For example:

      git submodule update --init
      pip install -r xgoogle/requirements.txt
      python xgoogle/ build
      python xgoogle/ install
      pip install -r requirements.txt


Before using, please read Google Terms of Service

Don't misuse our Services. For example, don't interfere with our Services or try to access them using a method other than the interface and the instructions that we provide.

It is provided for personal study and research.


usage: [-?] [-v] [-d DEST] [-s SITE] [-f FILETYPE] [-x]
                    [-t TIMEOUT] [-m MAXRESULTS] [-p RESULTSPERPAGE]
                    query [query ...]

positional arguments:
  query                 Query to search for.

optional arguments:
  -?, --help            Show this help message and exit
  -v, --verbose         increase output verbosity.
  -d DEST, --download-dir DEST
                        Directory to download files.
  -s SITE, --site SITE  Site to search for.
  -f FILETYPE, --file-type FILETYPE
                        File type to download.
  -x, --force-directories
                        Create a hierarchy of directories based on the URL.
  -t TIMEOUT, --timeout TIMEOUT
                        Set socket read timeout for downloading in seconds
  -m MAXRESULTS, --max-results MAXRESULTS
                        Set maximum results to scrape.
                        Set number of results per page.


Licensed under MIT license.

You can’t perform that action at this time.