Just about every app you use involves sending information to or receiving information from the internet.

If you want your app to connect to servers owned by other people, then you are going to have to deal with APIs (Application Program Interfaces). An API just means a standard way for some piece of software to talk to another piece of software. In this case, a way for your app to talk to some server somewhere. For example, you may use an API for getting weather information, an API for detecting faces or one of thousands of others.

Very often, the response you'll get from a server is formatted in JSON (JavaScript Object Notation). This sounds like a whole lot of work, but luckily, other programers have written libraries to make our life a whole lot easier!

Introducing JSON

We'll start off by getting used to working with JSON -- the format you'll likely receive responses from APIs in. Navigating a JSON file can be pretty messy in Swift, but it's a lot nicer when you use SwiftyJSON (a popular library).

JSON is a way of representing Arrays and Dictionaries of values (String, Int, Float, Double) as a text file. In a JSON file, Arrays are denoted by [ ] and dictionaries are denoted by { }.

Let's take a look at some JSON!

JSON Dictionary

Here's an example of what a dictionary looks like in JSON. The keys must be strings, and are separated from their associated values with a colon :.

  "Calories" : 210,
  "Fat" : 7,
  "Protein" : 14,
  "Carbohydrates" : 23

JSON dictionaries are also sometimes called JSON objects.

JSON Array

Here's what a JSON array looks like:

    "Isolated Soy Protein",
    "Tapioca Starch",

Example JSON content

Here's an example JSON response received from http://api.randomuser.me/ -- a testing API for generating fake user data.

  "results" : [
      "email" : "rose.moore@example.com",
      "gender" : "female",
      "name" : {
        "title" : "mrs",
        "first" : "rose",
        "last" : "moore"
      "nat" : "NZ",
      "cell" : "(302)-922-2080",
      "phone" : "(091)-223-5617",
      "login" : {
        "username" : "goldenmouse616",
        "password" : "shaker",
        "sha256" : "a53a4df8d7798149e6b75f652d246d0569d5d40c5bf41cff17befd540cee0cc4",
        "sha1" : "49ec83c662c0b0327d1eadec2bf006b93310d601",
        "salt" : "mTw9b4M6",
        "md5" : "a6bac151418455b103a126cfe0529416"
      "registered" : 1109275261,
      "dob" : 401570145,
      "picture" : {
        "large" : "https://randomuser.me/api/portraits/women/84.jpg",
        "thumbnail" : "https://randomuser.me/api/portraits/thumb/women/84.jpg",
        "medium" : "https://randomuser.me/api/portraits/med/women/84.jpg"
      "location" : {
        "state" : "wellington",
        "street" : "3992 north street",
        "city" : "masterton",
        "postcode" : 67068
  "info" : {
    "version" : "1.0",
    "results" : 1,
    "seed" : "536aa150a38f4a9b",
    "page" : 1

There is a Dictionary at the base with two keys: "results" and "info". All the stuff we want is in "results" which contains an array of dictionaries. In this case, there is only one dictionary in the array, because we only requested one random user. If we had requested more random users, there would have been multiple dictionaries (each containing information about a new random user) inside of the results array.

The dictionary has keys of "gender", "name", "location", "email", "login", and a few more! "gender" contains a String value of "female", while other keys like "name" contain another Dictionary with "title", "first", and "last" keys. Are you starting to see the pattern?

Now, how can we actually use this data?

Download the starter project

We've created a starter project for you with the libraries we'll be using already set up.

  1. Download the JSON & APIs starter project here.
  2. Unzip the project and move it to your projects folder.
  3. Go through the necessary steps to get this project on GitHub. Remember to commit often!
  4. Make sure that you open API-Sandbox.xcworkspace and not API-Sandbox.xcodeproj.

Introducing SwiftyJSON

SwiftyJSON allows us to access this data as if it were regular Swift arrays and dictionaries without having to deal with all sorts of annoying type casting at each level. It still can be messy to navigate JSON data, but SwiftyJSON makes it a lot easier.

In the Challenges.swift file you'll see a function named exerciseOne. For now, the most important part is these two lines:

let userData = JSON(data: jsonData)
let firstName = userData["results"][0]["name"]["first"].stringValue

jsonData holds the same data shown above. The first line loads the jsonData into a JSON object called userData. The second line navigates through the JSON object to get the first name as a string. Do you see what we did there? We navigated by getting:

  1. The array of dictionaries from the root with the "results" key
  2. The first dictionary of that array
  3. The dictionary stored with the "name" key
  4. The value in that dictionary for the "first" key
  5. Retrieved the value as a string with .stringValue

Can you trace that through the JSON above?

The line let firstName = userData["results"][0]["name"]["first"].stringValue could have also been written like this:

let results = userData["results"]
let firstRandomUser = results[0]
let nameDictionary = firstRandomUser["name"]
let firstName = nameDictionary["first"].stringValue

Your turn!

Save the other necessary values from this userData, and use them to print the following to the console:

<first name> <last name> lives at <street name> in <city>, <state>, <post code>. If you want to contact <title>. <last name>, you can email <email address> or call at <cell phone number>.

You'll need to pay close attention to the formatting of the JSON data above. Remember, some values are deeper in other dictionaries! We needed to get the "name" dictionary before we could access the first name.

Pay attention to the final values. Most are strings, but some are not - notice that all values do not have double quotes around them. You can access Int values with .intValue, Double values with .doubleValue, String values with .stringValue, etc.


If you have feedback on this tutorial or find any mistakes, please open issues on the GitHub Repository or comment below.

Summer academy

An iOS Development Summer Course

Design, code and launch your own app. Locations in San Francisco and Asia

Find your location

Product College

A computer science college

Graduate into a successful career as a founder or software engineer.

Learn more

Cookies on Make School's website

We have placed cookies on your device to ensure that we give you the best experience on our website.

This site uses cookies to deliver our services. By using our site, you acknowledge that you have read and understand our Cookie Policy, Privacy Policy, and our Terms of Service. Your use of Make School’s Products and Services is subject to these policies and terms.

Please note that Make School no longer supports Internet Explorer

We recommend upgrading to a modern web browser. Learn more