Awesome Open Source
Awesome Open Source


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.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
html (11,153
parsing (189
spreadsheet (95
cryptocurrencies (73
google-sheets (44