Import JSON into Google Sheets, this library adds various ImportJSON functions to your spreadsheet
Switch branches/tags
Clone or download
Latest commit 92688e8 Nov 15, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
archive Added archive link Jul 24, 2017
AUTHORS Added authors file Jul 24, 2017 Updated README Jul 24, 2017
LICENSE Created LICENSE Jul 24, 2017 Update Nov 15, 2018


Import JSON from any URL directly into your Google Sheets. adds an =ImportJSON() function to your spreadsheet, allowing quick and easy JSON importing. To use go to Tools > Script Editor and add the file. Now in your spreadsheet you can access the ImportJSON() function. Use it like this:

=ImportJSON(",avg=average_rank,tt=title,au=author,yr=year", "/title")

Here are all the functions available:

Function Description
ImportJSON For use by end users to import a JSON feed from a URL
ImportJSONFromSheet For use by end users to import JSON from one of the Sheets
ImportJSONViaPost For use by end users to import a JSON feed from a URL using POST parameters
ImportJSONBasicAuth For use by end users to import a JSON feed from a URL with HTTP Basic Auth
ImportJSONAdvanced For use by script developers to easily extend the functionality of this library

Review for more info on how to use these in detail.


  • v1.4.0 (July 23, 2017) - Project transferred to Brad Jasper. Fixed off-by-one array bug. Fixed previous value bug. Added custom annotations. Added ImportJSONFromSheet and ImportJSONBasicAuth.
  • v1.3.0 - Adds ability to import the text from a set of rows containing the text to parse. All cells are concatenated
  • v1.2.1 - Fixed a bug with how nested arrays are handled. The rowIndex counter wasn't incrementing properly when parsing.
  • v1.2.0 - Added ImportJSONViaPost and support for fetchOptions to ImportJSONAdvanced
  • v1.1.1 - Added a version number using Google Scripts Versioning so other developers can use the library
  • v1.1.0 - Added support for the noHeaders option
  • v1.0.0 - Initial release

How can you help?

Website archive

This code base used to be hosted at and contained a lot of useful information. It has been archived at


Some of this if possible internally with Google App Scripts External APIs, like UrlFetch:

These require a Google account and an explicit permission, but in some cases may be a good fit.