gspread is a Python API for Google Sheets.


  • Google Sheets API v4.
  • Open a spreadsheet by its title or url.
  • Extract range, entire row or column values.
  • Python 3 support.


pip install gspread

Requirements: Python 2.7+ or Python 3+.

Example Usage

  1. Obtain OAuth2 credentials from Google Developers Console
  2. Get a cell range from a spreadsheet:
import gspread

gc = gspread.authorize(credentials)

# Open a worksheet from spreadsheet with one shot
wks ="Where is the money Lebowski?").sheet1

wks.update_acell('B2', "it's down there somewhere, let me take another look.")

# Fetch a cell range
cell_list = wks.range('A1:B7')

How to Contribute

Please make sure to take a moment and read the Code of Conduct.

Ask Questions

The best way to get an answer to a question is to ask on Stack Overflow with a gspread tag.

Report Issues

Please report bugs and suggest features via the GitHub Issues.

Before opening an issue, search the tracker for possible duplicates. If you find a duplicate, please add a comment saying that you encountered the problem as well.

Contribute code

Please make sure to read the Contributing Guide before making a pull request.

Indices and tables