Overview

The PyImageSearch API is a free to collection of endpoints aimed at teaching concepts in computer vision and OpenCV. Right now the API only includes methods for face detection, but this will expand as the PyImageSearch blog grows and new articles are published.


POST: /face_detection/detect/

Detects faces in images either via uploaded file or URL of image. The response will include a JSON dictionary consisting of:

Key Data Type Description
success boolean Indicates whether or not the request was successful or not.
num_faces int Number of faces detected in the image.
faces list Starting and ending (x, y)-coordinates for each face in the image.

URL Upload Example

$ curl -X POST 'http://api.pyimagesearch.com/face_detection/detect/' -d 'url=http://www.pyimagesearch.com/wp-content/uploads/2015/05/obama.jpg'
{"num_faces": 1, "success": true, "faces": [[410, 100, 591, 281]]}

File Upload Example

$ curl -X POST -F image=@obama.jpg 'http://api.pyimagesearch.com/face_detection/detect/'
{"num_faces": 1, "success": true, "faces": [[410, 100, 591, 281]]}

For more examples on using the PyImageSearch web API, including examples in Python, please refer to this blog post.

[BASE URL: /, API VERSION: 1.0.0]