Skip to content
Import JSON into Google Sheets, this library adds various ImportJSON functions to your spreadsheet
HTML CSS JavaScript Roff
Branch: master
Clone or download

Latest commit

Latest commit ae64c90 Jun 2, 2019


Type Name Latest commit message Commit time
Failed to load latest commit information.
archive Added archive link Jul 24, 2017
AUTHORS Update AUTHORS Jan 12, 2019 updated versions Jun 2, 2019
LICENSE Created LICENSE Jul 24, 2017 updated versions Jun 2, 2019


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.6.0 (June 2, 2019) Fixed null values (thanks @gdesmedt1)
  • v1.5.0 (January 11, 2019) Adds ability to include all headers in a fixed order even when no data is present for a given header in some or all rows.
  • 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.

You can’t perform that action at this time.