![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D248BE0233D28263F53/en_US/fbd8d40651fff19a46e7aaedd4cb1b09.png)
Intro to using JSON in Shortcuts on Mac
JSON is a popular data-interchange format used by APIs (application programming interfaces). JSON lets you bundle a large amount of data into one chunk of text and then send it along to another service. All of the data values are given names, referred to as keys, and are combined with special characters like colons (:
) and braces ({
and }
) to form data objects.
In JSON, your values are structured into two types of data objects: dictionaries and lists.
A dictionary is an unordered collection of values that each have a unique key, together called key/value pairs. In JSON, they look like {key1: value1, key2: value2, key3: value3}
, and so on.
A list is simply an ordered collection of values. In JSON, they are comma-separated values surrounded in by brackets and look like [value1, value2, value3]
, and so on.
In both cases, you can set the values as text, numbers, Booleans (true or false), dictionaries, and lists.
JSON allows you to nest dictionary and list structures however you want. For example, you can nest a dictionary inside a dictionary or nest a list inside a dictionary. This allows you to model almost any structure of data, basic or complex, making JSON a powerful yet simple way to organize values as data objects.
For example, you can represent a person using a dictionary like:
{"first_name": "John", "last_name": "Appleseed", "age": 9}
Or, if you want a list of people, you can put the people dictionaries in a list like:
[{"first_name": "John", "last_name": "Appleseed", "age": 9},
{"first_name": "Kate", "last_name": "Bell", "age": 10},
{"first_name": "Anna", "last_name": "Haro", "age": 11}]
Note: For more information about the semantics of JSON, visit http://www.json.org.