JSON Face Data faces

The faces parameter is a flag that forces the fm=json parameter to include face data.

When faces=1, coordinate data for the bounds, mouth, left eye, and right eye of each face will be added to the JSON output. The coordinates start on the top left corner of the image.


faces=1&fm=json

{
  "Content-Length": "350176",
  "Content-Type": "image/jpeg",
  "Orientation": 0,
  "Faces": [
    {
      "bounds": {
        "y": 105,
        "x": 330,
        "height": 166.25,
        "width": 141.25
      },
      "confidence": 89
    },
    {
      "bounds": {
        "y": 196.25,
        "x": 455,
        "height": 147.5,
        "width": 130
      },
      "confidence": 88
    }
  ],
  "PixelHeight": 533,
  "PixelWidth": 800,
  "Output": {},
  "ProfileName": "sRGB IEC61966-2.1"
}

See the API specification for more information about this parameter's value ranges and format.