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 POST

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

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 Live Demo!

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

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1

Code Examples

1 2 3 4 5 6 7 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, headers={'X-Api-Key': 'YOUR_API_KEY'}) print(r.json())

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.