Documentation

faces JSON Face Data

The faces parameter is flag for the fm=json parameter to include face data. Coordinate data on 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. The parameter can only be set to the value of 1.

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
}