RapidAPI logo

Faceplusplus face detection

FREE
By faceplusplus
Updated 2 months ago
Media
9.3/10
Popularity Score
1622ms
Latency
90%
Success Rate

Faceplusplus face detection API Documentation

Detect the information of the given photo(e.g. face location, age, race, gender etc.)

View API Details
POSTFace Detection
POSTFace Landmark
POSTFace Detection

Detect the information of the given photo(e.g. face location, age, race, gender etc.)

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
image_urlSTRING
REQUIREDurl of the image to be detected
Optional Parameters
return_attributesSTRING
OPTIONALNone, or comma separated list of any of the following: (gender,age,smiling,headpose,facequality,blur,eyestatus,emotion,ethnicity,beauty,mouthstatus,eyegaze,skinstatus)
Code Snippet
unirest.post("https://faceplusplus-faceplusplus.p.rapidapi.com/facepp/v3/detect?image_url=https%3A%2F%2Fcnet3.cbsistatic.com%2Fimg%2Fgk7d6AQXuqmtPNmnZI2gMaNySyA%3D%2F970x0%2F2018%2F09%2F05%2F7274da05-85a9-4646-b41f-a4b22c597507%2Fcaptain-marvel-brie-larson-1.jpg")
.header("X-RapidAPI-Host", "faceplusplus-faceplusplus.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/x-www-form-urlencoded")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
Sample Response
General
Request URL: https://faceplusplus-faceplusplus.p.rapidapi.com/facepp/v3/detect
Request Method: POST
Response Headers
Response Body

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.post("https://faceplusplus-faceplusplus.p.rapidapi.com/facepp/v3/detect?image_url=https%3A%2F%2Fcnet3.cbsistatic.com%2Fimg%2Fgk7d6AQXuqmtPNmnZI2gMaNySyA%3D%2F970x0%2F2018%2F09%2F05%2F7274da05-85a9-4646-b41f-a4b22c597507%2Fcaptain-marvel-brie-larson-1.jpg")
.header("X-RapidAPI-Host", "faceplusplus-faceplusplus.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/x-www-form-urlencoded")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication