FaceRect is a powerful and free API for face detection. It finds faces (both frontal and profile) on the image specified by URL or uploaded as a file and is able to find multiple faces on a single photo, producing JSON output with a bounding box for each face found. Additionally FaceRect can find face features for each detected face (eyes, nose and mouth).

For more precise face feature detection please see our FaceMark API: https://www.mashape.com/apicloud/facemark

Demo

Online demo is available at http://www.apicloud.me/apis/facerect/demo/

Feel free to test the API as much as you like!

Documentation

The most recent and complete API documentation is always available at http://www.apicloud.me/apis/facerect/docs/

Last 7 days, UTC

Average Latency
77ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Endpoints

HTTP 200 : Response POST/process-file.json
JSON object that contains information on faces detected (visual demo: http://apicloud.me/apis/facerect/demo/)
						{
  "faces" : [
    {
      "orientation" : "frontal",
      "x" : 147,
      "y" : 161,
      "width" : 478,
      "height" : 478,
      "features" : {
        "eyes" : [
          {
            "x" : 277,
            "y" : 309,
            "width" : 62,
            "height" : 62
          },
          {
            "x" : 417,
            "y" : 295,
            "width" : 83,
            "height" : 83
          }
        ],
        "nose" : {
          "x" : 350,
          "y" : 406,
          "width" : 76,
          "height" : 64
        },
        "mouth" : {
          "x" : 319,
          "y" : 481,
          "width" : 146,
          "height" : 88
        }
      }
    }
  ],
  "image" : {
    "width" : 800,
    "height" : 800
  }
}						
Process Image File

Returns a JSON object that contains detected faces for the uploaded image (visual demo: http://apicloud.me/apis/facerect/demo/)


Test console
Description
Parameter
binary

Image you would like to find faces on. For supported image files and limitations please refer to the documentation: http://apicloud.me/apis/facerect/docs

image

Required

boolean

Specifies if you need to find face features (eyes, nose and mouth). If set to "true", the API will search for face features within faces detected (for frontal faces only). Default value is "false". For more information please refer to the documentation: http://apicloud.me/apis/facerect/docs

features

Optional

  • string – Indicates invalid call parameters: (e.g. URL not found, invalid image type or size, etc.). For more information please refer to the documentation: http://apicloud.me/apis/facerect/docs

    HTTP 400
  • string – Indicates internal API error (like image processing failure). However this case is very rare and we monitor all the API logs to fix issues as soon as possible.

    HTTP 500
HTTP 200 : Response GET/process-url.json
JSON object that contains information on faces detected (visual demo: http://apicloud.me/apis/facerect/demo/)
						{
  "faces" : [
    {
      "orientation" : "frontal",
      "x" : 147,
      "y" : 161,
      "width" : 478,
      "height" : 478,
      "features" : {
        "eyes" : [
          {
            "x" : 277,
            "y" : 309,
            "width" : 62,
            "height" : 62
          },
          {
            "x" : 417,
            "y" : 295,
            "width" : 83,
            "height" : 83
          }
        ],
        "nose" : {
          "x" : 350,
          "y" : 406,
          "width" : 76,
          "height" : 64
        },
        "mouth" : {
          "x" : 319,
          "y" : 481,
          "width" : 146,
          "height" : 88
        }
      }
    }
  ],
  "image" : {
    "width" : 800,
    "height" : 800
  }
}						
Process Image URL

Returns a JSON object that contains detected faces for the image specified by URL (visual demo: http://apicloud.me/apis/facerect/demo/)


Test console
Description
Parameter
string

URL of the image you would like to find faces on. For supported image files and limitations please refer to the documentation: http://apicloud.me/apis/facerect/docs
Example: http://apicloud.me/assets/facerect/image1.jpg

url

Required

boolean

Specifies if you need to find face features (eyes, nose and mouth) or just faces. If set to "true", the API will search for face features within faces detected (for frontal faces only). Default value is "false". For more information please refer to the documentation: http://apicloud.me/apis/facerect/docs

features

Optional

  • string – Indicates invalid call parameters: (e.g. URL not found, invalid image type or size, etc.). For more information please refer to the documentation: http://apicloud.me/apis/facerect/docs

    HTTP 400
  • string – Indicates internal API error (like image processing failure). However this case is very rare and we monitor all the API logs to fix issues as soon as possible.

    HTTP 500

Consume this API completely for free!


By joining the mashape API marketplace you can start using FaceRect API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.