Face Detect API

The Face Detect API uses state of the art computer vision algorithms to accurately and efficiently detect faces in images.

/v1/facedetect

HTTP POST

Given an input image, returns a list containing all detected faces in the form of bounding boxes.

Files

image (required) - image file containing faces. Must be either JPEG or PNG format.

Headers

X-Api-Key (required) - API Key associated with your account.

Sample Request URL

Live Demo!

https://api.api-ninjas.com/v1/facedetect

Sample Response


Code Examples


import requests

api_url = 'https://api.api-ninjas.com/v1/facedetect'
image_file_descriptor = open('YOUR_IMAGE.jpeg', 'rb')
files = {'image': image_file_descriptor}
r = requests.post(api_url, files=files)
print(r.json())
var formData = new FormData();
formData.append('image', $('#YOUR_IMAGE_FILE')[0].files[0]);
$.ajax({
    method: 'POST',
    url: 'https://api.api-ninjas.com/v1/facedetect',
    data: formData,
    enctype: 'multipart/form-data',
    processData: false,
    contentType: false, 
    success: function(result) {
        console.log(result);
    },
    error: function ajaxError(jqXHR, textStatus, errorThrown) {
        alert(jqXHR.responseText);
    }
});
If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.