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


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


  • image  required

    Image file containing faces. Must be either JPEG or PNG format.


  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!


Sample Response


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) 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.