This reference is for Processing 3.0+. If you have a previous version, use the reference included with your software in the Help menu. If you see any errors or have suggestions, please let us know. If you prefer a more technical reference, visit the Processing Core Javadoc and Libraries Javadoc.



String data = "{ \"id\": 0, \"species\": \"Panthera leo\", \"name\": \"Lion\"}";

void setup() {
  JSONObject json = parseJSONObject(data);
  if (json == null) {
    println("JSONObject could not be parsed");
  } else {
    String species = json.getString("species");

// Sketch prints:
// Panthera leo
Description Takes a String, parses its contents, and returns a JSONObject. If the String does not contain JSONObject data or cannot be parsed, a null value is returned.

parseJSONObject() is most useful when pulling data dynamically, such as from third-party APIs. Normally, API results would be saved to a String, and then can be converted to a structured JSONObject using parseJSONObject(). Be sure to check if null is returned before performing operations on the new JSONObject in case the String content could not be parsed.

If your data already exists as a JSON file in the data folder, it is simpler to use loadJSONObject().
input String: String to parse as a JSONObject
Updated on August 17, 2018 03:36:30pm EDT

Creative Commons License