Overview

Step into the world of advanced facial analysis with our revolutionary API! Our cloud-based solution is the fastest and most accurate face detection and analysis platform for a wide range of applications.

With our API, you can easily detect faces in images and gain a deeper understanding of emotions, gender, and facial landmarks. But that’s not all! Our state-of-the-art technology also enables you to recognize celebrities, compare faces from two different images, and even re-identify faces from your own custom face repository.

Our API empowers you to store multiple faces in your own face repository and search for specific faces using images, making it the ideal solution for security and facial recognition software applications.

We’ve developed our API to be scalable with low latency, allowing you to analyze large volumes of data at lightning-fast speed. Our technology is powered by the latest advancements in facial analysis, ensuring the highest level of accuracy and reliability.

Whether you’re developing security software or need advanced facial recognition capabilities, our API is the perfect solution. Choose our API for your face detection and analysis needs and discover the future of facial technology today!

Main Features

• Face detection
• Age, Gender, Emotion estimation
• Celebrity recognition
• Custum faces repositories
• Store facial features
• Faces re-identification
• Search faces in custum repositories

Endpoints

Face detect and analysis:

HTTP Method	URL	Description
POST	https://faceanalyzer-ai.p.rapidapi.com/faceanalysis	Detect and analyze faces with landmarks, gender, age, and emotion estimation
POST	https://faceanalyzer-ai.p.rapidapi.com/celebrity-recognition	Recognize celebrities from images
POST	https://faceanalyzer-ai.p.rapidapi.com/compare-faces	Compare faces from different images

---

Face Re-identification:

HTTP Method	URL	Description
POST	https://faceanalyzer-ai.p.rapidapi.com/create-facial-repository	Create custum facial repository to store facial feature
POST	https://faceanalyzer-ai.p.rapidapi.com/delete-facial-repository	Delete facial repository
GET	https://faceanalyzer-ai.p.rapidapi.com/list-facial-repositories	List created facial repository
POST	https://faceanalyzer-ai.p.rapidapi.com/save-face-in-repository	Save feature’s face in a repository
GET	https://faceanalyzer-ai.p.rapidapi.com/list-repository-faces	List repository’s faces
POST	https://faceanalyzer-ai.p.rapidapi.com/delete-face-from-repository	Delete feature’s face in a repository
POST	https://faceanalyzer-ai.p.rapidapi.com/search-face-in-repository	Search face in a repository by image

---

Face Analysis

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/faceanalysis
Methode	POST
POST Parameters	image: BINARY OR url: STRING
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode" :..,
  "faces": [
    {
      "boundingBox": ...,
      "facialFeatures":{
        "Gender": ...,
        "Smile": ...,
        "Eyeglasses": ...,
        "Sunglasses": ...,
        "AgeRange": ...,
        "Emotions": ...,
      },
      "landmarks":{
        "eyeLeft": ...,
        "eyeRight": ...,
        "mouth": ...,
        "nose": ...,
        "browLeft": ...,
        "browRight": ...,
        "chinBottom": ...,
      },
  }
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
Faces[]	array	List of detected faces
Faces[].boundingBox	object	bounding box of face item
Faces[].facialFeatures.Gender	string	“male” or “femal”
Faces[].facialFeatures.Smile	boolean	True if smile detected
Faces[].facialFeatures.Eyeglasses	boolean	True if eyeglasses detected
Faces[].facialFeatures.Sunglasses	boolean	True if sunglasses detected
Faces[].facialFeatures.AgeRange	array	estimated age range of face item: [low_age hight_age]
Faces[].facialFeatures.Emotions	array	emotion of detected of face item [low hight]
Faces[].landmarks	object	face landmark’s of face item

---

Celebrities recognition

Parameters

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/celebrity-recognition
Methode	POST
POST Parameters	image: BINARY OR url: STRING
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode" :..,
  "celebritiesFaces": [
    {
      "boundingBox": ...,
      "facialFeatures": ...,
      "landmarks": ...,
      "celebrityName": ...,
      "celebrityUrlsInfo": ...,
  }
  ]
  "unrecognizedFaces": [
    {
      "boundingBox": ...,
      "facialFeatures": ...,
      "landmarks": ...,
  }
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
celebritiesFaces[]	array	List of celebrities faces
celebritiesFaces[].celebrityName	string	The name of celebrity item
celebritiesFaces[].celebrityUrlsInfo	array	Urls information of celebrity item
unrecognizedFaces[]	array	List of unrecognized faces

---

Compare Faces

Parameters

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/compare-faces
Methode	POST
POST Parameters	sourge_image: BINARY OR source_image_url:STRING | target_image: BINARY OR target_image_url: STRING
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode": ...,
  "matchedFaces": [
    {
    "boundingBox": ...,
    "landmarks": ...
  }
  ],
  "unmatchedFaces" : [
    {
    "boundingBox": ...,
    "landmarks": ...
  }
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
matchedFaces[]	array	List of faces in the target image that match the source image face
unmatchedFaces[]	array	List of of faces in the target image that did not match the source image face

---

Create facial repository

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/create-facial-repository
Methode	POST
POST Parameters	repository_id: STRING
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

Response Schema

"responses": {
  "statusCode": ...,
  "message": ...
}

Field	Type	Description
statusCode	int	Status code of image processing
message	string	OK if repository created

---

Delete facial repository

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/delete-facial-repository
Methode	POST
POST Parameters	repository_id: STRING
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode": ...,
  "message": ...
}

Field	Type	Description
statusCode	int	Status code of image processing
message	string	OK if repository deleted

---

List facial repositories

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/list-facial-repositories
Methode	GET

---

Response Schema

"responses": {
  "statusCode": ...,
  "FacialRepositoriesId": [
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
FacialRepositoriesId[]	array	Ids of created facial repositories

---

List repository faces

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/list-repository-faces
Methode	GET
Query string	repository_id

---

Response Schema

"responses": {
  "statusCode": ...,
  "Faces": [
    {
    "FaceId": ...,
    "ExternalImageId": ...
  }
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
Faces[]	array	list of faces in repository
Faces[].FaceId	string	Id of face item
Faces[].ExternalImageId	string	External Image Id of face item

---

Save face in repository

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/save-face-in-repository
Methode	POST
POST Parameters	image:BINARY ==OR== url:STRING, repository_id:STRING, external_id:STRING, max_faces:NUMBER
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode": ...,
  "faces_id": [
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
faces_id[]	array	Ids list of saved faces

---

Delete face from repository

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/delete-face-from-repository
Methode	POST
POST Parameters	repository_id:STRING, face_ids:ARRAY
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode": ...,
  "message": ...
}

Field	Type	Description
statusCode	int	Status code of image processing
message	array	OK if faces deleted

---

Search face in repository

Proprity	Description
URL	https://faceanalyzer-ai.p.rapidapi.com/search-face-in-repository
Methode	POST
POST Parameters	image:BINARY ==OR== url:STRING, repository_id:STRING
Supported content-type	application/x-www-form-urlencoded | multipart/form-data

---

Response Schema

"responses": {
  "statusCode": ...,
  "SearchedFaceBoundingBox": ...
  "FaceMatches": [
    {
    "Similarity": ...
    "Face": 
      {
      "FaceId: ...
      "BoundingBox: ...
      "ExternalImageId: ...
    }
  }
  ]
}

Field	Type	Description
statusCode	int	Status code of image processing
SearchedFaceBoundingBox	object	The boundingbox around the face in the input image used for the search
FaceMatches[]	array	List of faces that match the input face
FaceMatches[].Similarity	int	similarity score of matched face item
FaceMatches[].Face.FaceId	string	face id of matched face item
FaceMatches[].Face.BoundingBox	object	boundingbox of matched face item
FaceMatches[].Face.ExternalImageId	string	External id of matched face item

---