Our Celebrity Recognition API detects the presence of well-known figures in images. It is powered by our face detection and face similarity models, as well as a curated and constantly updated Custom Search Index. Our index now contains over 40,000 figures.
Given an input image, the model detects all faces present and returns a bounding box (defined as a set of vertices) and a match for each, as well as a confidence score. It also returns an attribute category
, which describes what type of famous figure the recognized individual is.
In this API's JSON response, match
is defined as a string corresponding to the name of the matching famous figure. If a face is not matched with any figure in the index, it is not included in the response. If there are no matches found, the bounding_poly
property of the response will be empty.
An example of a full JSON response is shown below:
{
"status": [
{
"status": { "code": "0", "message": "SUCCESS" },
"response": {
"input": {
"hash": <HASH>,
"charge": 0.00001,
"media": {
"url": null,
"filename": "0x0.jpg",
"type": "PHOTO",
"mime_type": "jpeg",
"mimetype": "image/jpeg",
"width": 416,
"height": 416,
"num_frames": 1,
"duration": 0
},
"id": <ID>,
"model_type": "CELEBRITY_RECOGNITION",
"model": "facenet_ensemble_v2",
"created_on": "2025-04-21T22:43:23.012Z",
"inference_client_version": "0.0.0",
"model_version": 1,
"user_id": <USER_ID>,
"project_id": <PROJECT_ID>,
"config_version": 1,
"config_tag": "default"
},
"output": [
{
"time": 0,
"bounding_poly": [
{
"classes": [
{
"class": "Xi Jinping",
"score": 0.9602784514427184,
"category": "politician"
}
],
"vertices": [
{ "y": 39.45117950439453, "x": 122.70075988769533 },
{ "y": 286.9783630371094, "x": 122.70075988769533 },
{ "y": 286.9783630371094, "x": 332.2042541503906 },
{ "y": 39.45117950439453, "x": 332.2042541503906 }
],
"meta": { "type": "face" },
"dimensions": {
"top": 39.45117950439453,
"right": 332.2042541503906,
"left": 122.70075988769533,
"bottom": 286.9783630371094
}
}
]
}
]
}
}
]
}