Documentation

faces JSON Face Data

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
{
  "Faces":[
    {
      "bounds": {
        "y": 273,
        "x": 326,
        "height": 168,
        "width": 168
      },
      "mouth": {
        "y": 230,
        "x": 402
      },
      "right_eye": {
        "y": 159,
        "x": 426
      },
      "left_eye": {
        "y": 150,
        "x": 397
      }
    },
    {
      "bounds": {
        "y": 356,
        "x": 460,
        "height": 146,
        "width": 146
      },
      "mouth": {
        "y": 310,
        "x": 556
      },
      "right_eye": {
        "y": 239,
        "x": 536
      },
      "left_eye": {
        "y": 284,
        "x": 496
      }
    }
  ],
  "JFIF": {
    "DensityUnit": 1,
    "YDensity": 72,
    "JFIFVersion": [
      1,
      1
    ],
    "XDensity": 72
  },
  "ColorModel": "RGB",
  "Depth": 8,
  "ProfileName": "sRGB IEC61966-2.1",
  "PixelHeight": 533,
  "PixelWidth": 800,
  "DPIWidth": 72,
  "DPIHeight": 72
}