Skip to main content
Version: Streamsheets 3.0

JSON.VALUE

Returns a value from a JSON object. The value to return corresponds to the path specified by given keys. Please refer to JSON.TO.RANGE for writing the complete data of a JSON object to the sheet.

Syntax

=JSON.VALUE(JSON, Key1...KeyN)

Arguments

NameTypeDescription
JSONJSONA JSON object to read value from.
Key1...KeyNStringA list of keys which build up a path within given JSON object.

Return

TypeDescription
StringThe value at specified path or an error if no JSON object is passed or path is invalid.

Examples

AB
1{"Name": "Peter", "Kids": ["Paul", "Mary"]}}
FormulaResultComment
=JSON.VALUE(JSON(A1),"Customer","Name")
PeterValue at Customer.Name
=JSON.VALUE(JSON(A1),"Customer","Kids", 1)
MaryValue at Customer.Kids[1]
=JSON.VALUE(JSON(A1),"Customer","Kids", "Name")
#NAInvalid json path